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Preface 


Purpose 


This publication presents a guide to the use of the Virtual Machine/ Extended Archi- 
tecture System Product dump viewing facility, which is a program that allows the 
user to analyze and manage system software problems in an interactive mode under 
the conversational monitor system (CMS) for VM/XA SP. The dump viewing 
facility runs in System/370 mode. 


Audience 


_ This publication 1s for anyone who needs to use dump viewing facility to analyze 
( dumps. 


How to Use This Publication 


Use the first part of the book, including Chapter 2, as a usage guide. The rest of the 
book is intended to be used as a reference manual. The reference manual contains 
commands, subcommands, and messages of dump viewing facility. 


(_ __ Related Publications 
| See the Bibliography at the back of this publication. 
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Chapter 1. Introduction 


Major Functions 
The dump viewing facility assists in the following tasks: 
e Interactively analyzing dump data 
¢ Formatting and printing dump data 


e Reducing trace tables created by trace service tools. 


interactively Analyzing Dump Data 
The dump viewing facility provides a variety of commands and subcommands that 
os allow the user to interactively locate and display dump data. Using the dump 
( : viewing facility you can: 


¢ Display real program status words, registers Gncluding vector registers and des- 
ignated elements), clocks, and the timer 


¢ Display formatted data from any Virtual Machine/Extended Architecture™ 
System Product (VM/XA™ SP) control block or data area 


¢ Display data in hexadecimal and EBCDIC 
e Display data using 24- or 31-bit indirect addressing 


( ¢ Display a chain of control block addresses in hexadecimal or display the data 
= within the control blocks 


¢ Locate a hexadecimal or EBCDIC string in the dump 
¢ Print output from any DUMPSCAN subcommand 
¢ Determine a module entry point and displacement, given an address 
¢ Determine an address, given a module or entry point name 
( ¢ Scroll forward or backward while viewing hexadecimal data 


¢ Create a load map of module names and their entry points with addresses and 
displacements 


° Assign symbolic names to subcommands 


¢ Format, reduce and scroll through trace tables within a dump. 


Formatting and Printing Dump Data 
The dump viewing facility uses a dump file created by the CMS DUMPLOAD 
command to print summary reports. For CP dumps, these reports contain data from 
major CP control blocks and data areas. For VM dumps, there 1s limited informa- 
tion given. The summary reports available are: 


e Virtual machines. 


Virtual Machine/Extended Architecture and VM/XA are trademarks of the International Business Machines Corpo- 
ration. 


Chapter 1. Introduction I 


e Individual virtual machines with associated virtual I/O devices. 

¢ Real I/O devices. | fo 
e Real storage frame tables. 

© Trace table entries. 

¢ Module load maps. 

e Symptom records. 

¢ General processor information. 

¢ Dumpid (for virtual machine dumps only). 


¢ For VM dumps of type GCS and RSCSV2, formatting of (VTAM type and 
VSCS type) control blocks, provided the formatting routine exit is taken. See 
Appendix E for more information. | 


Using the CMS DUMPLOAD command, you can print all pages of dumped storage yo 
in hexadecimal. 


Reducing Trace Tables Created by Trace Service Tools 
The dump viewing facility processes data trace information as well as CP trace table 
data. In addition, you can merge CP trace table information with data trace infor- 
mation and view it in chronological sequence. VM/XA SP records CP system trace 
table data in system trace files or to tape. 


VM/XA SP provides three different types of data tracing. VM/XA SP records this 
trace information in system trace files. These three types are: 


e CP data trace. Allows you to trace the most used paths in the CP code. You 
can use CP commands to specify what type of data you wish CP to record. 


e I/O data trace. Allows you to trace I/O instruction streams, as well as data 
streams, coming from the I/O devices you select. 


e Guest data trace. Allows you to trace data of virtual machines or groups of 
virtual machines. The virtual machine or group of virtual machines must use the | 
MONITOR Call Class 10 instruction in application programs to actually send at 
the trace data to CP. CP records the trace data in a system data file for the 
requesting virtual machine or group of virtual machines. ~ 


Types of Dumps the Dump Viewing Facility Processes 


You can use the dump viewing facility to process any of the following kinds of 
dumps: 


* CP (control program), including stand-alone dumps 

© VM (virtual machine) 
The VM dumps you can use with the dump viewing facility are as follows: 
—- CMS (conversational monitor system). 
— GCS (group control system). 


— Pass-Through. In this instance, Pass-Through refers to both the 
VM/Remote 3270 Display Option and Pass-Through Virtual Machine 
(PVM). 
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— RSCSNET (Remote Spooling Communications Subsystem) Version 1. 
( = — RSCSV2 (Remote Spooling Communications Subsystem) Version 2. 


Note: Throughout this document, for information on stand-alone dumps, see the 
sections that discuss CP dumps. For information on CMS, GCS, Pass- 
Through, RSCSNET and RSCSV2 dumps, see the sections that discuss VM 
dumps. 


Requirements for Using the Dump Viewing Facility 


To use all the functions the dump viewing facility provides to examine a dump, you 
need the following: 


¢ The dump viewing facility installed on your system. 


For information about installing the dump viewing facility, see the VM/XA 
System Product: Installation and Service manual. 


( ; e A-copy of the dump you want to examine loaded into a CMS file. 


e In some instances, a copy of the load map that describes the system from which 
your dump was taken. 


For specific information on when the dump viewing facility requires a load map 
and how one is created and processed, see “Using Load Maps” on page 12 in 
this document. 


| Storage Requirements 
( The disk storage requirements for the dump viewing facility include space for the CP 
es dump and the CP load map when it is used. A virtual machine load map and dump 
require less storage than a CP load map and dump. Therefore, the requirements 
given here should be viewed as a maximum. Figure 1 shows the space requirements 
in cylinders for the CMS file containing the load map: 


3350 
8 


Figure 1. Space Requirements in Cylinders for the Load Map File 


After processing with the dump viewing facility MAP command, the dump viewing 
facility module map fits on 1 cylinder of disk space on any of the above devices. 


Figure 2 shows the space requirements in cylinders for each 16 megabytes of 
dumped storage with the dump viewing facility module map appended dynamically 
or appended by the ADDMAP command. 
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BLKSIZE | 3330 3340 3350 3315 


Figure 2. Space Requirements in Cylinders per 16 Megabytes of Dumped Storage 


Causes for a Dump 


In VM/XA SP, dumps can be initiated by hardware, software, or a user. The cause 

of the dump determines the type of dump: CP, CMS, GCS, RSCSNET, RSCSV2, yor, 
PVM, or stand-alone. For instance, if a machine check occurred, a CP dump would ' 
result. If a user issued the VMDUMP command in a CMS virtual machine, a CMS 

dump would result. 


Note: If CP was unable to take an abend dump, you can initiate a stand-alone 
dump. 


To initiate a stand-alone dump, use the stand-alone dump utility. See the VM/XA 
SP: Planning and Administration guide for information on creating the stand-alone 
dump utility. See the VM/XA SP: Real System Operation manual for information 
on running the stand-alone dump utility program. 


Hardware-initiated Dumps 
Not all hardware errors result in a dump being taken. Some examples of hardware 
errors that do result in dumps are the following: 


¢ Machine checks in the central processor 
e Storage checks in main storage 
¢ Channel checks in the I/O channels. a 


Some hardware errors cause a dump to be taken immediately as a result of a ee 
machine check condition. Other errors may alter the condition of the hardware (for 

example, a processor or main storage) in a manner that eventually will cause CP to 

detect an abnormal condition and take an abend dump. 


If a dump is taken, it may contain symptoms of the hardware error. You may find 
additional symptoms by examining the hardware error log in the error recording cyl- 
inders, using the environmental recording, editing, and printing (EREP) facility, and 
by examining messages sent to the system operator’s console. 


Software-Initiated Dumps 
Generally, a software error occurs when a sequence of instructions executed by a 
processor results in a condition that is incompatible with the design of the software 
system. Software errors have a variety of symptoms. Some typical symptoms are: 


Loop A sequence of instructions is executed over and over again, 
infinitely. 
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Wait The software system cannot find work to do, or it 
encounters a condition that cannot be resolved. 


Lockout A userid has become disabled, nondispatchable, or has no 
work-tasks to be run. 

Storage overlay A program has stored data in the wrong location in real 
storage. 

Invalid data A system control block or data area contains data that is 


inconsistent or erroneous. 


Invalid address A control block or data area contains an address that is | 
outside the storage areas to which the program has access. 
Or, a control block or data area points to a nonexistent 
control block. Since some addresses are generated by pro- 
grams from data in control blocks, an invalid address can be 
generated if the data is in error. 


Invalid instructions An instruction is found that does not conform to the system 
architecture, possibly because it has been modified in main 
storage. 


Invalid addresses and instructions result in program checks. The other kinds of soft- 
ware errors are usually detected by CP as abnormal conditions. Both result in 
abnormal termination of CP and a dump being taken. 


User-Initiated Dumps 


System Restarts 


A system restart is usually initiated by the system operator, and results in a dump 
being taken. The system is usually restarted when a problem exists in the hardware 
or software that results in a wait, loop, or lockout of one or more important userids, 
or in degraded performance. In these situations, it is usually desirable to reinitialize 
CP. System restart can perform this reinitializing and capture the circumstances of 
the problem in the dump. 


VMDUMP Command 


The CP command, VMDUMP, produces a dump of all or selected pages of storage 
that appear real to your virtual machine (second-level storage). In order for the 
resulting dump to be usable by the dump viewing facility, you must issue the CMS 
DUMPLOAD command to load the dump into a CMS file. The dump includes 
selected information for the virtual processor on which you issued the VMDUMP 
command. For more information on and the exact syntax of the VMDUMP 
command, see the VM/XA SP: CP Command Reference. 


Location of a Dump 


The dump taken 1s sent to a printer, a tape, or to the virtual reader of a specific 
virtual machine (userid). If a dump is to be analyzed using the dump viewing 
facility, 1t must be directed to tape or to a virtual reader. One userid commonly 
used for dumps is OPERATNS. The destination of the dump is determined by using 
the CP SET DUMP command. The SET DUMP command 1s described in the 
VM/XA SP: CP Command Reference. 
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Use of Dump Information _ = 


You can use data from a dump to assist in locating the source of the problem that | < 
caused the dump. As we have already discussed, in VM/XA SP, a dump may result 
from any of the following: 


need 


e A hardware error 

e A software error 

¢ The system operator initiating a system restart 

e A user issuing the CP command VMDUMP. 
The way you proceed to narrow your search for the cause of the dump is to use the 
following two main steps: 


Problem determination Finding out whether the problem is caused by 
hardware or software. 


Problem source identification Isolating the problem to a particular compo- 
nent of the software system. 


Once you identify the cause of the error as being within the software, you can use 
error messages and the symptom record to refine your analysis of the problem 
further. 


These steps are discussed below. 


Problem Determination Ne? 


The goal of problem determination 1s to discover whether the dump was the result of 
a hardware or software error. Sometimes the clues are obvious. For example, if a 
machine check, channel check, or storage check preceded the dump, the problem 
most likely is a hardware error. If the dump is a CP abend dump, the cause is very 
likely a software error. When a restart dump has been taken, you probably will 
have to examine the conditions of both the hardware and software to make the 
determination. 


Once you have determined whether the problem is hardware or software, problem Neo 
determination is complete. From this point on, the ciscussion focuses on performing 
problem source identification for software. 


Performing Problem Source Identification 


Problem source identification is the second step in analyzing a software problem. It 
consists of isolating the cause of a problem to a particular component of the soft- 
ware system. The VM/XA System Product has four components: 


e The control program (CP) 
e The conversational monitor system (CMS) 


¢ The dump viewing facility 


e The group control system (GCS). 
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In addition to these three components, there are several program products that can 
run in the VM/XA SP environment. Problem source identification is complete when 
you have determined the particular component or program in which the error 
occurred. 


Using Error Messages 


One method of determining where the problem occurred is to examine any error 
messages in the dump. These messages usually identify the immediate cause of the 
dump. For example, a CP abend dump is identified as such by a message. CMS 
and the dump viewing facility also issue messages when they detect errors. Similar 
messages may be sent to the system operator’s console. You can look at these mes- 
sages in the VM/XA SP. System Messages and Codes Reference and in the messages 
section, “Chapter 5. Messages and Message Summaries” on page 159, of this 
manual. The message descriptions tell which component failed and briefly describe 
the error conditions encountered. 


If a message indicates that an error occurred in CP, you can use the message code to 
determine which module in CP encountered the error. The scenarios in this chapter 
describe this in more detail. 


Using the Symptom Record to Identify Duplicate Problems 


Whenever CP terminates abnormally, it creates a symptom record which is included 
in the dump. The symptom record summarizes data about the state of the system 
when the dump was taken. The dump viewing facility can format the symptom 
record for display and printing. See the SYMPTOM subcommand of DUMPSCAN 
in Chapter 4 of this manual for more information on symptom records. 


You can use the keywords and formatted data from the symptom record to deter- 
mine whether the problem has occurred on your system before. You can compare 
the symptom record data in a new dump to symptom records in dumps that already 
exist, keyword by keyword. A match on all the data indicates that the new problem 
may be a duplicate. 


You can search for duplicate problems using the dumps on file at your installation. 
You can also ask the IBM Support Center to search the IBM data base. This data 
base contains information about all the problems reported to IBM by VM/XA SP 
users. 


Commands of the Dump Viewing Facility 


The dump viewing facility provides five commands. The commands are MAP, 
ADDMAP, DUMPSCAN, PRTDUMP, and TRACERED. 


Note: The following information on the MAP and ADDMAP commands is 
required for non-CP dumps. For CP dumps, you can use the dynamic map 
building function of the DUMPSCAN and PRTDUMP commands. For 
more data on when you do and do not need to use the MAP and ADDMAP 
commands, see “Load Maps for CP Dumps” on page 12. 


1. The MAP command compresses the VM/XA SP load map created at system 
generation time into a format that the dump viewing facility can process. The 
compressed module map is used to correlate module and entry point names with 
addresses in the dump. You do not have to use the MAP command for CP 
dumps. Both the DUMPSCAN and PRTDUMP commands dynamically create 
and append a module map to a CP dump. 
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. Use the ADDMAP command to append the compressed module map to the 


CMS file containing the dump processed by the DUMPLOAD command. (For 
more information about the CMS DUMPLOAD command, refer to the VM/XA 
System Product: CMS Command Reference manual). ADDMAP processing also 
resolves the addresses of pageable CP modules that were in storage at the time 
of the dump. If you use the dynamic map build and append functions of the 
DUMPSCAN and PRTDUMP commands for a CP dump, you do not need to 
use the ADDMAP command. 


. Use the DUMPSCAN command to interactively view CP, stand-alone, and 


virtual machine dumps. The DUMPSCAN subcommands are described in 
Chapter 4 of this manual. For CP dumps, if a module map is not already 
appended to the dump, DUMPSCAN dynamically creates and appends one. 


. Use the PRTDUMP command to obtain a printed copy of any or all of the 


summary reports available through the dump viewing facility. Each summary 
report contains data the problem solver most frequently requires. For CP 
dumps, if a module map is not already appended to the dump, PRTDUMP 
dynamically creates and appends one. 


. Use the TRACERED command to read and create a CMS or print file con- 


taining the trace data saved to tape or DASD by the CP TRSAVE command. 
You may specify certain selection criteria be applied to the trace entries. And, 
you may designate whether the trace information is output as either hexadecimal 
or formatted data. : 


You may also use TRACERED to collect GCS guest trace records in a simu- 
lated OS QSAM file. This allows programs, such as ACF/TAP licensed 
program, to process the GCS guest trace data. 


Figure 3 illustrates the command structure for the ADDMAP, DUMPSCAN, MAP, 
and PRTDUMP commands. Figure 4 illustrates the command structure for the 
TRACERED command. 
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Figure 3. Command Structure for the Dump Viewing Facility’ss ADDMAP, DUMPSCAN, MAP, and PRTDUMP 
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Figure 4. Command Structure for the Dump Viewing Facility’s TRACERED Command 


Servicing the Dump Viewing Facility | 


Corrective and preventive maintenance of the dump viewing facility is performed 
using standard VM/XA SP procedures. Refer to the VM/XA System Product: Instal- 
lation and Service manual for information on these maintenance procedures. 


Writing Dump Data to Tape 


To ship dump data to IBM service personnel or for offline storage, you can write 
dump data to tape using existing CMS commands. 

Refer to Appendix D, “Dumping the Abend Dump to Tape” on page 233 for more 
information on dumping to tape. 
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Preparing a Dump for Use with the Dump Viewing Facility 7 


If you wish to use the dump viewing facility to analyze a dump, you first have to 
prepare the dump by following these steps: 


1. When VM/XA SP becomes available again, log on to a userid. 
The userid must: 


e Be the userid to which the dump was sent, if the dump was sent to a virtual 
reader 


¢ Have enough unused space on its A-disk to hold the dump file. 


( . Refer to the section “Storage Requirements” on page 3 for the amount of 
storage required for dumps. 


i) 


. Use the DOUMPLOAD command to load the dump into a CMS file. 


Issung DUMPLOAD puts the CMS file containing the dump onto the A-disk 
of the receiving userid. The file will be named PRBxxxxx DUMP A, where 
xxxxx is a number from 00000 to 00009, depending on the names of the dump 
files already on the A-disk. 


If you wish to print an unformatted dump, use the PRINT option of the 
( . DUMPLOAD command. For information on the VM/XA SP DUMPLOAD 
command, see the VM/XA SP: CMS Command Reference manual. 


3. Rename the dump file by using the CMS RENAME command. 


When renaming the dump file, keep the general format of filename DUMP A. 
The filename can be from one to eight characters in length. For information on 
the VM/XA SP RENAME command, see the VM/XA SP: CMS Command Ref- 
erence manual. 


We recommend you rename the file because the DUMPLOAD command 
( | restricts the file names to PRB00000 through PRB00009. The dump viewing 
, facility allows file names in the form xxxxxxxx where xxxxxxxx is a 1- to 
8-character string that may consist of the characters 0-9, A-—Z, @, #, —, _, +. 
:, and §. 


A file that has a name of PRB00000 should be renamed before using the dump 
viewing facility. If dump files PRB00000 through PRBO00009 already exist, 
DUMPLOAD erases PRB00000 before loading the current dump into a CMS 
file. 


4. Create and append a module map to the dump you wish to examine. 
There are two ways to do so. 
e Use the MAP and ADDMAP commands. 


Using the MAP/ADDMAP method requires that a load map be created and 
then converted to a module map. See the sections below for more informa- 
tion on load maps and module maps. 


e For CP dumps hard abend and standalone dumps only, use the dynamic 
map build function of DUMPSCAN or PRTDUMP. 
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Using Load Maps 


Load Maps for CP Dumps 


In this section, any reference to a CP dump is to a hard abend or standalone dump. 


There are certain instances when you need a copy of the CP load map created at 
system generation time: 


¢ If you want to see certain data areas; for example, HCPSYSCM. 


* If you want to see what modules existed at system generation time but were 
paged out when the dump was taken. 


Load Maps for VM Dumps 
The dump viewing facility does not dynamically generate module maps for VM 
dumps. Therefore, it requires a VM load map. 


Creating Load Maps 


In this section, any reference to a CP dump is to a hard abend or standalone dump. 


As stated above, you need to create a load map in two instances for CP dumps, and 
in every instance for VM dumps. 


Note: Create and save a new load map whenever a new system is generated in all 
cases for using a VM load map and in the two cases when you need a CP 
load map. If you don’t, the module map that is converted from the load map 
will not match the dump to which it is appended, and incorrect data will be 
presented. 


CP Load Maps 


To create a CP load map, see the VM/XA SP Installation and Service manual. 


VM Load Maps 
To create a CMS or GCS load map, see the VM/XA SP Installation and Service 


manual. To create a PVM load map, see the VM/SP Pass-Through Guide and Refer- 


ence. To create an RSCSNET load map, see VM/SP RSCS Networking Reference 
and Operations manual. To create an RSCSV2 load map, see the VM/SP RSCS 
Networking Version 2 Planning and Installation manual. 


Creating Module Maps 


In this section, any reference to a CP dump is to a hard abend or standalone dump. 
The following section explains how to create and append module maps for use with 
the dump viewing facility. 
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CP Module Maps 


There are two methods by which you can convert a CP load map into a module map 
and append it to a CP dump: 


1. Allow the dump viewing facility to create and append the module map dynam- 
ically by using the DUMPSCAN or PRTDUMP command 


2. Use a two-step process that employs the MAP and ADDMAP commands with a 
CP load map as input. 


a. Use the MAP command to convert a load map into a module map which 
then can be appended to the dump. 


b. Use the ADDMAP command to append the module map to the dump you 
specify in the command. For CP dumps only, ADDMAP translates the 
addresses of pageable CP modules from virtual addresses to real addresses. 


VM Module Maps 


( * There is one method by which you can convert a VM load map into a module map 

and append it toa VM dump. That method is a two-step process that employs the 
MAP and ADDMAP commands. See the section above, on page 13, for a 
description of what the MAP and ADDMAP commands do. For more information 
on use of the commands, see “Chapter 3. Command Reference” on page 33. 


The dump file is now ready for use with the dump viewing facility. One task you 
may wish to perform frequently is viewing the dump. The use of the DUMPSCAN 
command for viewing a dump is explained next. 


Viewing Dumps 


To view a dump, access it using the dump viewing facility DOUMPSCAN command. 
For example, if the dump you wish to analyze is in the file named HUNGUSER 
DUMP A, you can enter the command: 


dumpscan hunguser 


When the dump file has been accessed, you are notified by the READY status 
( 7 message. You are in an XEDIT environment ready to enter DUMPSCAN subcom- 
| mands on the command line. | 


Ali the commands used to view dump data in the dump file are subcommands of the 
DUMPSCAN command. They are explained in Chapter 4. Some of these subcom- 
mands are used in the dump analysis scenarios in this chapter. See “Scenario 1: 
Analyzing a CP STK017 Abend Dump” on page 20 and “Scenario 2: Analyzing a 
CP FREO016 Abend Dump” on page 24. 


Using the Session File 
The dump viewing facility makes use of full screen XEDIT functions so that you can 
scroll back and forth through dump data in full-screen mode. You can scroll 
through any data previously viewed without reissuing the command to display the 
data. You can edit your session file while in the dump viewing facility. This anno- 
tation feature allows you to make comments within a dump session file before 
passing the dump on to the next level of problem determination. 


The dump viewing session can be filed by issuing the XEDIT subcommand FILE. 
The session is stored on the user’s A disk. In the future, if you want to view the 
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same dump, this file will be reactivated and this new session will then be appended 
to the dumpname DUMPVIEW file containing previous session or sessions. ae 


Viewing Dumps of Licensed Programs 
The dump viewing facility provides additional support for viewing data particular to 
specific virtual machine dumps. This support is comparable to that of VM/SP Inter- 
active Problem Control System (IPCS). With this support a user is able to make use 
of IPCS formatting routines to find and format data in licensed programs’ virtual 
machine dumps and display it via the dump viewing facility. 


The dump viewing facility provides this support for dumps taken from the following: 


e Conversational monitor system (CMS) 

« Group control system (GCS) 

e Pass-Through Virtual Machine (PVM) 

¢ Remote Spooling Communications System Version 1 (RSCSNET) 


¢ Remote Spooling Communications System Version 2 (RSCSV2). 


See Appendix E for more information regarding this support. 


Analyzing Dumps 


The discussion of software errors on page 4 pointed out that software problems have 
a variety of symptoms. Two examples of symptoms are used in this chapter’s sce- | | 
narios to illustrate one way of analyzing CP abend dumps, using the dump viewing ‘7 
facility. 


Analyzing Trace Tapes 


The dump viewing facility also enables you to view trace tables saved to tape. The 
CP command TRSAVE saves the trace tables; the dump viewing facility command 

TRACERED formats the trace tables if you request that it be done and it formats 

the trace tables into a CMS or print file. See page 46 for more specific information 
on the use of the TRACERED command. 


Analyzing Trace Data as System Files 


The dump viewing facility processes data trace information as well as CP trace table 
data. In addition, you can merge CP trace table information with data trace infor- 

mation and view it in chronological sequence. VM/XA SP records CP system trace 

table data in system trace files or to tape. 


Writing DUMPSCAN Macros 


The DUMPSCAN subcommands help you to interactively analyze dump data, and 
in most situations there is a subcommand that will give you the needed data ina 
usable format. However, you can write macros to customize and automate the 
powers of DUMPSCAN, creating your own powerful tools to analyze dump data. 
By writing macros, you can: 
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e Expand the basic subcommand set 
¢ Tailor the basic subcommand output for: 
— Dump data summary reports in a specific format 
— More readable format, such as changing technical jargon to English 
— Additional annotations 
— Additional time/date/tracking information. 
¢ Eliminate repetitive tasks. 
This section explains how to write XEDIT macros using DUMPSCAN subcom- 
mands and describes the DVFXEDIT profile. You should be familiar with the 
Restructured Extended Executor(REXX) language. See the VM/XA System Product 
Interpreter User's Guide and the VM/XA System Product: System Product Interpreter 
Reference for more information on REXX. You should also be familiar with 
XEDIT. See the VM/XA System Product Editor User's Guide and the VM/XA 


System Product: System Product Editor Command and Macro Reference for more 
information on XEDIT. 


This section describes some usage of XEDIT subcommands, but it is not intended to 
give you a complete guide to writing macros. 


What Is a DUMPSCAN Macro? 


A DUMPSCAN macro is a EXEC file you invoke from the DUMPSCAN environ- 
ment. This environment exists whenever DUMPSCAN is being used. 


You execute a macro the same way you execute a DUMPSCAN subcommand. 
Type the macro name on the command line and press the ENTER key. A macro 
can be executed by entering only its name or its name and any parameters needed 
for its execution. 


A macro file can contain: 


¢ DUMPSCAN subcommands 

¢ XEDIT subcommands 

e REXX instructions 

* Other REXX or EXEC2 EXECS 
e CMS and CP commands. 


A macro file should not contain: 
* Any dump viewing facility command 


¢ Any CMS command that does not run in subset mode or runs in the user area. 


Generally it is safe to run any EXEC from within the DUMPSCAN environment. 
But, reexecuting DUMPSCAN from within DUMPSCAN or executing any other 
command that runs in the user area will have unpredictable results. 
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Creating a Macro File 
JA macro is a normal CMS file. It may be created in any of the ways that CMS a a. 
provides for file creation. Like any CMS file, a macro is identified by filename, \ 

filetype, and filemode. Its creation must conform to the following rules: 


¢ The filename may be 1-to-8 alphabetic characters. 
* The filetype should be XEDIT or EXEC. 


¢ The filemode can be any of the disks to which you have write access, usually 
your A-disk. 


Using DUMPSCAN Subcommands in a Macro 


A macro can contain any DUMPSCAN subcommand. Most subcommands look for 
specific data in the dump, format it, and write it to the session record. However, 

the DUMPSCAN macro subcommands are meaningful only from within a macro 
since they pass information to the system product interpreter. _ 


What Is an Environment? 
When you write a macro, you need to know which command processor will inter- 
pret your command. The system product interpreter looks at the instructions first 
within a macro. If the instructions are not interpreter instructions, they are passed 
to the environment for interpretation. The environment is the command processor 
that gets the instructions after the system product interpreter has done any symbolic 
substitution. 


You can specify the environment with the REXX instruction ADDRESS: ; 
¢ ADDRESS SCAN causes the macro instruction to be passed to DUMPSCAN. ‘ 
® ADDRESS XEDIT causes the macro instruction to be passed to XEDIT. 

e ADDRESS CMS causes the macro instruction to be passed to CMS. 


¢ ADDRESS by itself causes the macro instruction to be passed to the default 
environment. 


The default environment is created when you use XEDIT as the filetype for your 
macro. XEDIT is the default environment. When you use EXEC as the filetype for eS 
your macro, then CMS is the default environment. \ 


DUMPSCAN Macro Subcommands FINDSTRG, READSTRG, and NOTE 
FINDSTRG and READSTRG are subcommands that you can only use from within 
a macro. READSTRG allows you to read from the dump and place that data 
directly into a REXX variable. FINDSTRG allows you to locate data in the dump 
and put the address of the matching data into a REXX variable. With these two 
commands, you can extract and format any addressable data within the dump. 


NOTE is a subcommand for annotating the session file. It can also be used to anno- 
tate the print file produced by DUMPSCAN subcommands when the PRINT ON 
subcommand is used. | 


The remaining DUMPSCAN subcommands can be used in a macro, but the output 
from those subcommands is placed in the session file. If you need this subcommand 
output, you must use XEDIT subcommands to get the records into the program 
stack or into REXX variables. See “DUMPSCAN Macro Example” on page 17 for 
an example of how the output of the CPU subcommand is taken from the session 
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a file. Once the needed data is in a macro variable, the subcommand is removed from 
( the session file. Not all DUMPSCAN subcommands are used in the examples, but 
te the technique is the same. 


Communicating between the Editor and the Interpreter 
The READ and EXTRACT subcommands of XEDIT can supply the macro with 
data from the DUMPSCAN command line or from the session file. The READ 
subcommand takes information from the screen and places it in the program stack. 
The information in the stack can be the command line, changed lines, prefix area, 
and program function key definitions (PF keys). The macro gets the information 
from the program stack with the REXX PULL instruction. The EXTRACT sub- 
command can supply a macro with information about internal XEDIT variables or 
about file data. The information is returned in one or more REXX variables, which 
can be examined or used by the macro. 


_ READ Subcommand 
( : When a READ subcommand is issued from a macro, the editor redisplays the 
, current screen and waits for the user to press ENTER or a PF key. After a key is 
pressed, the requested data is placed in the program stack. 


Operands of the READ subcommand can be used to specify how much information 
is placed in the program stack. A subsequent REXX PULL instruction assigns the 
data to program variables, and the macro continues. 


EXTRACT Subcommand 
A EXTRACT is issued from a macro. The information is returned in REXX variables. 
( The EXTRACT subcommand returns information about editor variable settings. 

These are needed when the macro changes an XEDIT variable and restores it before 
ending. The example that follows uses the EXTRACT subcommand to get records 
from the data file and to determine data file parameters such as the number of 
records in the file and the position of the current line. The EXTRACT command 
has many options. For a complete discussion of the options read the VM/XA System 
Product: System Product Editor Command and Macro Reference. 


Displaying Data on the DUMPSCAN Screen 


( To move prompts and messages from the macro to the DUMPSCAN screen you can 
= use the XEDIT subcommands MSG, EMSG, CMSG, and INPUT. 


MSG Displays a message on the message line 

EMSG Displays a message on the message line and sounds the alarm 
CMSG Displays a message on the command line 

INPUT Puts the message or text in the session file following the current line 


and makes the new line the current line. 


DUMPSCAN Macro Example 
The following example shows you how to use a combination of XEDIT subcom- 
mands and DUMPSCAN subcommands to create a new DUMPSCAN function. In 
this case, a new DUMPSCAN subcommand Is created by a macro which displays 16 
bytes from a specified offset within the prefix page. To get the same information 
using DUMPSCAN subcommands from the command line would require you to 
issue the CPU subcommand, write down the prefix page address, add the offset to 
that address, then issue the DISPLAY subcommand. 
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00001 /*DUMPSCAN Subcommand Macro a 7 | << 
00002 /* Display the data at the specified offset from +) 
00003 /* the failing Bioeeee or prefix page. i A 


00004 
00005 
00006 
00007 


00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 


hg 


i 


Parse arg offset . 


Parse source . 


- Macroname . 


"EXTRACT /LINE/MSGMODE ' 
00008 If offset = '' Then Do 
Emsg ‘Command format is:' macroname ‘offset' 
Cmsg macroname | 


exit 
end 


'EXTRACT/SIZE/' 


Address SCAN ‘CPU' 
's'size.1+1 'EXTRACT/CURLINE/' 
parse var curline.3 ....... pfxpgad . a 


'SET MSGMODE OFF' 
's'size.il+1 'DEL *' 


‘SET MSGMODE' MSGMODE.1 MSGMODE.2 


's']ine.1 


Address SCAN ‘Display’ d2x(x2d(pfxpgad)+x2d(offset)) 'F OFFSET' 


exit 


Figure 5. A DUMPSCAN Macro Example 


00001 /* DUMPSCAN Subcommand Macro */ pe 
An interpreter comment. The first line must be a comment. ‘ \ 
eo” 
00002 /* Display the data at the specified offset from */ 
00003 /* the failing processor prefix page. */ 
00004 /* ~) 


00005 Parse arg offset . 


This instruction says to take the first operand and assign it to the variable offset. 
The period says to disregard any other operands. 


00006 Parse source .. macroname . 


Here the macro gets its name from CMS. Again the periods mean that any a 
other file information is not needed. | 


00007 ‘EXTRACT/LINE/MSGMODF’ 
The EXTRACT XEDIT subcommand will return the line number at the XEDIT 
current line and the XEDIT message settings. 


00008 If offset = ” Then Do 
Check for the required operand and if it was not entered, then issue an error 
message to the user. DO is the first statement of a series of instructions. This 
set of statements ends at line 00012. 


00009 Emsg ‘Command format is:’ macroname ‘offset’ 
Use XEDIT EMSG to tell the user the correct way to use this macro. 


00010 Cmsg macroname 
Use XEDIT CMSG to put the macro name back on the command line in case 
the user wants to try the macro again. 


00011 exit 
Since the macro cannot do anything, the EXIT instruction will cause control to 
return to the caller. 
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00012 end 
END is the last instruction of a DO statement, this one started at line 00008. 


( ; 00013 “EXTRACT /SIZE/’ 
Use the XEDIT EXTRACT subcommand to find the size of the current file. 


00014 Address SCAN ‘CPU’ 
The ADDRESS command changes the environment to SCAN for the following 
subcommand. SCAN is the name of the DUMPSCAN environment. CPU 1s a 
DUMPSCAN subcommand that lists the CPU names and the prefix page 
address of all CPUs contained in the dump. 


00015 ’:’size.1+1 ’EXTRACT/CURLINE/’ 
Reset the current line to the CPU subcommand first output line and EXTRACT 
the line into the CURLINE.3 variable. 


00016 parse var curline.3....... pixpgad . 
Break the curline variable into its parts and ,ignoring some parts, assign the 
prefix page address to the pfxpgad variable. 


( : 00017 ‘SET MSGMODE OFF’ 
Use XEDIT SET to suppress any messages. 


00018 ’:’size.1 +1 ’DEL *’ 
Remove the CPU subcommand output from the file. 


00019 ‘SET MSGMODE’ MSGMODE.1 MSGMODE.2 
Turn the messages back to their previous settings. 


00020 ’:’line.1 
Reset the current line to its position when we started. 


( 00021 Address SCAN ‘Display’ d2x(x2d(pfxpgad) + x2d(offset)) ‘F OFFSET’ 
| Switch to the DUMPSCAN environment, and after the interpreter works 
through the calculation, issue the DUMPSCAN DISPLAY subcommand with 
the OFFSET operand for 15 bytes. 


00022 exit 
EXIT indicates the macro is finished. 


— DVFXEDIT Profile 
( | DVFXEDIT XEDIT is a macro distributed with the dump viewing facility that mod- 
, ifies a standard XEDIT session to the special DUMPSCAN format. This macro can 
be modified to change the session format to your preference. You should not 
change the definition of the ENTER key. 


Assigning Program Function Keys to DUMPSCAN Subcommands 
The PF keys default to XEDIT functions in the DUMPSCAN environment. The PF 
keys are assumed to be for XEDIT functions. You can assign keys to DUMPSCAN 
subcommands or DUMPSCAN subcommand macros by putting an XEDIT SET 
command in a copy of the DVFXEDIT XEDIT macro that you keep on your 
A-disk. 


For example, you may want to assign PF keys 4 and 5 to the DUMPSCAN 
FORWARD and BACKWARD subcommands. You would put the XEDIT sub- 
commands SET PF04 SCAN BACKWARD and SET PF05 SCAN FORWARD in 
your DVFXEDIT XEDIT macro. SET is an XEDIT subcommand name that 
changes XEDIT system variables. PFO04 is the name of an XEDIT system variable. 
SCAN is the CMS command that gives you access to DUMPSCAN subcommand 
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processing. BACK WARD is the name of the DUMPSCAN subcommand that dis- 
plays addresses lower than the last addresses displayed. | a 


Scenario 1: Analyzing a CP STK017 Abend Dump 


In this scenario, CP terminated abnormally with an STKO17 abend code and a 
dump. The steps that follow suggest one way this problem could be analyzed. The 
analysis is designed to meet three objectives: problem determination, problem source 
identification, and information gathering. 


Step 1: Checking the Error Message and Symptom Record 


There are two methods for determining the reason for an abend: 
¢ Checking the error and informational messages displayed on your screen, or 


e Using the SYMPTOM subcommand of the DUMPSCAN command in the 
VM/XA SP dump viewing facility. 


Checking the Error and Informational Messages 
The system operator was notified of the problem by the message: 


HCPDMP908I SYSTEM FAILURE ON CPU 0002, CODE - STK017 


HCP indicates that the message is from the control program (CP). DMP indicates 
that module DMP wrote the message. 908I is the message number. Using this 
information, look up the message in the VM/XA System Product: System Messages 
and Codes Reference. If you’re unsure of where to look, check the Preface for the 
organization of the book. For this scenario, the explanation in Messages and Codes or 
indicates that CP encountered a severe software failure that caused a dump to be | 
taken. 


The message text also indicates that an abend occurred. The CP abend code in the 
message 1s STKO17. 


You can find the explanation for this particular abend code in, Section 1: CP Abend 

Codes of the VM/XA System Product: System Messages and Codes Reference 

manual. The explanation for a STKO017 code is that the value for the VMDBK 

scheduler list identifier is unrecognizable and the probable cause for the abend is —_ 
that the VMDBK has logged off. YH 


Using the SYMPTOM Subcommand of DUMPSCAN in the Dump Viewing Facility 
In order to use any commands or subcommands in the dump viewing facility, you 
first have to load the dump you wish to view into a CMS file by using the CMS 
command DUMPLOAD. Then you can proceed to use the dump viewing facility’s 
other subcommands. 


In this example, assume you already have loaded the dump you want to examine in 
a CMS file and assume you have issued the DUMPSCAN command for the dump. 
Proceed by entering the subcommand SYMPTOM to display formatted symptom 
record information. Figure 6 shows an example of the output you receive if you 
enter the SYMPTOM subcommand for an STK017 abend. 
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==>Dumpscan Release 2.0 <===> DumpName DUMP0Q16 <===> DumpType 
---- SYMPTOM RECORD FOR CPDUMPO1 ---- 


TIME OF DAY CLOCK: 9CFCO23A9E5E0600 CPU MODEL: 3084 
TIME ZONE: -5 CPU SERIAL: 999999 


DUMP TYPE: CPDUMP 


BASE OPERATING SYSTEM COMPONENT ID: VMAB 
RELEASE: 2 
FEATURE: 


SYMPTOM STRING: 
AB/SSTK017 (ABEND CODE) 
PIDS /566430801 (COMPONENT ID) 
RIDS /HCPSTK (FAILING MODULE) 
REGS /06802 (REGISTER/PSW DIFFERENCE) 


Figure 6. Output Format of the SYMPTOM Subcommand 


The symptom string information is interpreted as follows: 


-¢ The module that issued the abend is STK and the reason code for the abend is 
017 as indicated by the ABEND CODE field. 


e The component identifier for this product is 566430801 as indicated by the 
COMPONENT ID field. 


e The identifier of the failing module is HCPSTK as indicated by the FAILING 
MODULE field. 


Baie es 


¢ Register 6 had an offset of 802 from the current PSW at the time the dump was 
taken as indicated by the REGISTER/PSW DIFFERENCE field. 


we At this point, problem determination and problem source identification are com- 

( | plete. The error has been identified as a software error, and it occurred in the CP 

i | component VM/XA SP. Your next step is to gather more information about the 
abend. 


Step 2: Analyzing the Trace Table 
Aside from its SYMPTOM subcommand, the dump viewing facility can help you 
gather additional data about the circumstances of this failure. 


The CP trace table contains information about activity in the system. The proc- 
essing flow in CP just prior to the abend is in the most recent trace entries. Use the 
TRACE subcommand of DUMPSCAN to view these entries on your display screen. 
If you enter TRACE FORMAT, the subcommand formats and displays the last 
trace entries merged from all processors. 


e The last trace entry made before CP abended is displayed at the bottom of your 
( , screen. As Figure 7 shows, the trace code is 0200. 
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® a 
® : 
0200 CPU 0002 SVC INTERRUPTION TOD FF40386DC400 ADR O1F3A520 
ABEND CODE ILC INT CODE SVC OLD PSW 
STKOL7 0004 0002 000C1000 8099460E 


Figure 7. Last Trace Entry in the CP Trace Table with Abend STKO017 


This is the trace entry for the CP abend. You can see that the information in the 
entry corresponds to the primary symptom in the dump: the STKO17 abend. 


The next-to-last trace entry is of greater interest since it shows what CP processing 
occurred just prior to the abend; see Figure 8. It is trace code 3300, STACK 


CPEBK: 
a I gear a Tena Tat me get San NTT gn @ Gents woo DN Pree” Og ay wns ag = eee orem a ae oS 
| ee CPU 002 STACK CPEBK TOD FF40386DC400 ADR 01F3A500 
| 
STATE SLIST CPEXSCHC VMDBK ADDR CPEBK ADDR MOD/DISP ADDR 
2C 00 80 01BD7000 O1F5AD10 LCK/1D0 
0200 CPU 0002 SVC INTERRUPTION TOD FF40386DC400 ADR 01F3A520 \ 
ABEND CODE LEC INT CODE SVC OLD PSW ‘ ; 
STKO17 0004 0002 Q00C1000 8099460E ae 
Se 


Figure 8. Second-to-Last Trace Entry from the CP Trace Table 
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Module HCPLCK requested that a CPEBK be stacked for eventual execution by 
CP. The call to HCPSTK occurred at hexadecimal 1D0 bytes from the beginning of 
HCPLCK. 


Step 3: Finding the VMDBK 


Recall from the description of the STK0O17 abend that the VMDBK may not exist 
because the user has logged off. You can find the address of a VMDBK in the 3300 
STACK CPEBK trace entry. It represents the userid for which the CP execution 
task (CPEBK) was to be performed. The VMDBK’s address is 1BD7000, and you 
can display it using the VMDBK subcommand: 


vmdbk at 1bd7000 


This subcommand should display a summary of the VMDBK at the address 
1BD7000. But in this case, because the user has logged off, the response is the fol- 
lowing message: 


THE VMDBK PAGE WITH ADDRESS 01BD7000 IS NOT IN THE DUMP 


Although the address of the VMDBK points to a page that isn’t in the dump, there 
is a way to check the status of the page. The frame table (FRMTE) contains the 
status of every page frame in real storage and the FRMTE 1s always in storage. 
You can determine the status of the VMDBK page with the FRAMETBL subcom- 
mand: 


frametb] 1bd7000 


This subcommand causes the following information to be displayed on your screen: 


FRAME TABLE ENTRY 303000 FRAME USE = AVAILABLE 
PAGE TABLE ENTRY = 00000000 


FORWARD POINTER 
STATIC FLAGS 

DYNAMIC STATES 
SERIALIZE FLAGS 


Q01BD8C70 BACKWARD POINTER = 01AE7F90 
QQ NO FLAGS SET 

00 NO FLAGS SET 

80 ON AVAILABLE QUEUE 


Figure 9. Determining the Status of the VMDBK Page with the FRAMETBL Subcommand 


You can see that the frame is on the available list for the dynamic paging area. It is 
possible that the user did log off, and that the page was returned to the dynamic 
paging area for use as a user page. This would account for the frame flag settings 
and the AVAILABLE frame use. 


You can see that the possibility that the user logged off is supported by the value of 
SLIST displayed in the 3300 STACK CPEBK trace entry. SLIST is the VMDBK 
data element named VMDSLIST, and it identifies the scheduler list to which the 
VMDBK 1s currently assigned. You can locate the definition of VMDSLIST by 
examining the CP COPY blocks (the listing that contains the definitions of CP 
control blocks), and by locating the VMDBK COPY file. Locate VMDSLIST in the 
VMDBK. The valid values for VMDSLIST are: 


USER IS IN THE DISPATCH LIST 
USER IS IN THE ELIGIBLE LIST 
USER IS IN THE DORMANT LIST 
VIRTUAL MACHINE IS NOT IN A LIST 


The VMDBK must'be on one of the first three lists if it is logged on. The only time 


it is not on a scheduler list is when it is logged off. 
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Since the SLIST value indicates the virtual machine is not in a list, the user must 
have been logged off. 


Step 4: Summarizing the Dump Analysis 
By examining these two trace entries and the frame table, you have found the imme- 
diate reason for the STK017 abend. You can summarize the diagnostic information 
in the dump as follows: 


1. CP terminated with an STKO1L7 abend. 


2. Immediately before the abend, HCPLCK called HCPSTK to stack a CPEBK for 
the VMDBK at location hex 1BD7000. 


3. The SLIST value in the VMDBK contains zeros, which indicates the VMDBK 
(userid) was not logged on to the system when HCPSTK was called. 


4. The page that contained the VMDBK has been released for use in the dynamic 
paging area. 


You now know enough information to begin searching for duplicate problems at 
your installation. If no duplicates are found, your next step is to contact the IBM 
Support Center to report the problem and its symptoms. 


Scenario 2: Analyzing a CP FRE016 Abend Dump 


In this scenario, CP terminated abnormally with a FRE016 abend code and a dump. 

The steps that follow suggest one way this problem could be analyzed. The analysis 

is designed to meet three objectives: problem determination, problem source identifi- 
cation, and information gathering. 


Step 1: Checking the Error Message and Symptom Record 


There are two methods for determining the reason for an abend: 
¢ Checking the error and informational messages displayed on your screen, or 


¢ Using the SYMPTOM subcommand of the DUMPSCAN command of VM/XA 
SP dump viewing facility. 


Checking the Error and Informational Messages 
The system operator was notified of the problem by the message: Ses, 2 


HCPDMP908I SYSTEM FAILURE ON CPU 0000, CODE - FREO16 


HCP indicates the message is from the control program (CP). DMP indicates that 
module HCPDMP wrote the message. 9081 is the message number. Using this 
information, look up the message in the VM/XA System Product: System Messages 
and Codes Reference. If you’re unsure of where to look, check the Preface for the 
organization of the book. For this scenario, the explanation in Messages and Codes 
indicates that CP encountered a severe software failure that caused a dump to be 
taken. 


The message text also indicates that an abend occurred. The CP abend code in the 
message 1s FREO16. 


You can find the explanation for this particular abend code in, Section 1: CP Abend 
Codes of the VM/XA System Product: System Messages and Codes Reference. The 
explanation for a FREO16 code is that the requester of the free storage block has 
written beyond the free storage block. The free storage TRAILER is destroyed. 
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Using the SYMPTOM Subcommand of DUMPSCAN in the Dump Viewing Facility 
In order to use any commands or subcommands in the dump viewing facility, you 
first have to load the dump you wish to view into a CMS file by using the CMS 
command, DUMPLOAD. Then you can proceed to use the dump viewing facility’s 
DUMPSCAN subcommands. 


In this case, we have renamed the file, DUMP016. For this example, assume you 
already have loaded the dump you want to examine in a CMS file and proceed to 
use the SYMPTOM subcommand to display formatted symptom record information. 


An example of the output you receive if you enter the SYMPTOM subcommand for 
an FREO16 abend follows: 


==>Dumpscan Release 2.0 <===> DumpName DUMP016 <===> DumpType CP <=== 


~--- SYMPTOM RECORD FOR DUMPO16 ---- 


( TIME OF DAY CLOCK:  9D31A16B56129660 CPU MODEL: 3081 
TIME ZONE: -4 CPU SERIAL: 999999 


DUMP TYPE: CPDUMP 


BASE OPERATING SYSTEM COMPONENT ID: VMAB 
RELEASE: 2 
FEATURE: 


( SYMPTOM STRING: 
AB/SFREO16 (ABEND CODE) 
PIDS /566430801 (COMPONENT ID) 
RIDS /HCPGRF (FAILING MODULE) 
REGS/OE4DA (REGISTER/PSW DIFFERENCE) 


Figure 10. Output Format of the SYMPTOM Subcommand 
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The symptom string information is interpreted as follows: 


¢ The module that issued the abend is FRE and the reason code for the abend is ‘ r 
016 as indicated by the ABEND CODE field. ct 


e The component identifier for this product is 566430801 as indicated by the 
COMPONENT ID field. 


e The identifier of the failing module is HCPGRF as indicated by the FAILING 
MODULE field. 


¢ Register 14 had an offset of 4DA from the current PSW at the time the dump 
was taken as indicated by the REGISTER/PSW DIFFERENCE field. 


At this point, problem determination and problem source identification are com- 
plete. The error has been identified as a software error, and it occurred in the CP 
component of VM/XA SP. Your next step is to gather more information about the 
abend. 


Step 2: Analyzing the Trace Table 
Use the dump viewing facility to gather additional data about the circumstances of 
the failure. You can use the TRACE subcommand of DUMPSCAN to view these 
entries on your display screen. You first must enter the DUMPSCAN environment 
by entering the dump viewing facility DUMPSCAN command with the dump file 
name. You can now enter TRACE FORMAT, causing TRACE to format and 
display the last trace entries merged from all processors. The last trace entry (the 
one displayed at the bottom of the screen) is trace code 0200. 


CPU 0000 SVC INTERRUPTION TOD A16875BF5640 ADR OOFF1F60 
ABEND CODE [LC INT CODE SVC OLD PSW 
FREO16 0002 0000 Q00C2000 80366514 


Figure 11. Last Trace Entry in the CP Trace Table with Abend Code FREO16 


This is the trace entry for the CP abend. You can see that the abend code is Me 
FREO16. The address at which the abend was issued is in the second word of the 

SVC OLD PSW. You can obtain the name of the module that issued the abend by 

entering the FINDMOD subcommand with the address: 


findmod 366514 


00366514 IS CE4 BYTES INTO MODULE HCPFRE AT 00365830 


00366514 IS 69C BYTES INTO ENTRY HCPFRET AT 00365E78 


Figure 12. Finding the Name of a Calling Module with the FINDMOD Subcommand 


The name of the module is HCPF RE, and the abend was issued at the instruction 
located at hex CE4 bytes from the beginning of the module. 


The information in this trace entry corresponds to the primary symptom in the 
dump: the FREO16 abend. The next-to-last trace entry is of greater interest, since it 
shows what CP processing step occurred just prior to the abend. To view the trace 
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entries again, use XEDIT scrolling capabilities to scroll to previous subcommand 
aa output, or reenter the TRACE subcommand. Now you can examine the next-to-last 
( trace entry. It is trace code 0700, RETURN FREE STORAGE (FRET): 


0700 CPU 0000 RETURN FREE STORAGE (FRET) TOD A16875B5CC60 ADR OOFF1F40 
BLOCK ID DOUBLE WORDS BLOCK ADDR VMDBK ADDR MOD/DISP 


<<<< 00000006 OOFBBOEO OOFACOOO GRF FB4 


0200 CPU Q000 SVC INTERRUPTION TOD A16875BF5640 ADR OOFF1F60 
ABEND CODE ILC INT CODE SVC OLD PSW 
FREQ16 0002 0000 Q00C2000 80366514 


Figure 13. Second-to-Last Trace Entry from the CP Trace Table 


( You can see in the trace entry that 6 doublewords at address OOFBBOEO were 
returned to free storage by the module HCPGREF at displacement FB4. 


Immediately prior to the FRE016 ABEND, HCPGRF returned 6 doublewords of 
storage at location OOFBBOEO. 


Step 3: Analyzing Free-Storage Trace Fields 
Module HCPFRE builds trace fields to aid in debugging problems associated with 
ane FREE/FRET storage requests. These trace fields are a part of the storage allocated 
( by HCPFRE to satisfy a storage request. 


HCPFRE adds 1 doubleword to the front of each request (free-storage header) and 2 
doublewords at the end (free-storage trailer) as shown in Figure 14. 


Header FREESIZE FREESFLG 


Storage ; FREESTOR 


Trailer FREELD | FREEEFLG 
Trailer FREEDISP FREEMOD 


Figure 14. Free-Storage Header and Trailers Added to Free Storage 
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The contents of these doublewords are as follows: 


FREESIZE The size, in doublewords, of the original free-storage request. —_ 


FREESIZE is located at X'0' in the header. = 


FREESFLG | Four greater-than signs (>>>>) indicating the beginning of the 
free-storage area. FREESFLG is located at X'4' in the header. 


FREESTOR The free-storage area, which is variable in size, depending on the 
value in FREESIZE. | 


_ FREEID The control block identifier. EBCDIC representation of the name 
of the control block occupying the free storage. Note that four 
less-than signs (<<<<) means a variable length block without a 
specific identifier. FREEID is located at X'0' in the trailer. 


FREEEFLG Four less-than signs (<<<<) indicating the end of the free-storage 
area. FREEEFLG is located at X'4' in the trailer. 


FREEDISP The offset, or displacement, of the free-storage request into the 
calling module. FREEDISP is located at X'08' in the trailer. 


FREEMOD The last three characters of the module ID requesting free storage. 
FREEMOD is located at X'C' in the trailer. 


Use the DISPLAY subcommand to examine the storage HCPGRF was trying to 
return to free storage (FRET): 


display OOFBBOEO 


This subcommand displays a full screen of storage beginning at address 0OOFBBOEO. 
After looking at module HCPGRF using a source listing or microfiche, and exam- . 
ining the hexadecimal data beginning at OOFBBOEO, we determined that HCPGRF one 
was trying to return to free storage (FRET) a 6-doubleword block. 


In-depth examination of the header and trailer doublewords enables you to deter- 
mine which free-storage trace fields were the source of the FRE016 abend. 


Since the free-storage header is 1 doubleword long, in order to determine the head- 

er’s address you must subtract 8 bytes from the address contained in the trace table 
entry. Use the subcommand DISPLAY 00FBBOD8 (OOFBBOEO minus X'8') to — 
look at the storage header: ~ 


display 00fbb0d8 
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QOFBBODO 
QOOFBBOEO 
QOFBBOFO 
QOFBB100 
OOFBB110 
QOOFBB120 
Q00FBB130 
QOFBB140 
OOFBB150 
QOFBB160 
QOFBB170 
QOFBB180 
QOFBB190 
OOFBB1A0 
Q0OFBB1B0 
QOOFBB1CO 
OOFBB1D0 
OOFBB1EO 
OOFBB1FO 
OOFBB200 
OOFBB210 
QOFBB220 
QOFBB230 
QOFBB240 
OOFBB250 
O0OFBB260 
> 


This subcommand displays a full screen of storage beginning at address FBBODO: 


==>Dumpscan Release 2.0 
DISPLAY OOFBBOD8 


045A0372 
115B5F1D 
C7404040 
90000000 
Q04C4C4C 
Q0OFBB168 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


<===> DumpName DUMP0O16 


OOC4D4C1 
C1115D6B 
40404040 
00000000 
4AC4C4c4C 
00000009 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


00000006 
1D60QD9E4 
40404040 
00000000 
80000F 84 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


6EG6EGEGE 06 * 


D5D5C9D5 
00000000 
00000000 
00C7D9C6 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


<===> DumpType CP <=== 


* .$7.A.),.-RUN 


DMA... .>>>>* 


NIN* 
* 


*G Susaee 


+ $F F FF HF F FF FF F HF F HF F HF F F F SF HK F 


+ FF FF HF FF F HF HF HF HF HF F HF HF HF HF F HF F 


Figure 15. Hexadecimal Data Displayed as a Result of the DISPLAY Subcommand 


The header and trailer data included in the displayed information are listed below. 
( a At hexadecimal address FBBOD8, the free-storage header contains the following 
values: 


00000006 6E6EGE6E 


At hexadecimal address FBB110, the free-storage trailer contains the following 
values: 


OO4C4C4C 4C4C4C4C 80000F84 OO0C7D9C6 


Use the data in the header and trailer fields to perform the following analysis: 


1. Examine the contents of FREESIZE (the size, in doublewords, of the requested 
block of storage) and compare it with the size of the free storage returned 
(FRET) in the CP FRET trace table entry. The sizes should be identical. 


2. Examine the contents of FREESFLG and verify that 1t contains four greater- 
than signs (>>>>). 
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3. Locate the trailer by converting the FREESIZE from doublewords to bytes. In 
this case, X'6' doublewords = X'30' bytes. Add this to the beginning address 
of the block (not to the address of the free-storage header): 

X'QQFBBOEO' + X'30' = X'OOFBB110' 


4. Examine the FREEID and verify that it contains the valid control block identi- 
fier. This can be done by issuing the REGS subcommand and comparing the 
contents of Register 0 with FREEID. | 


An example of the output you receive if you enter the REGS subcommand 
follows: 


==>Dumpscan Release 2.0 <===> DumpName DUMP016 <===> DumpType CP <=== 
REGS 
CPU ADDRESS - 0000 PREFIX REGISTER - 0032D000 
GENERAL REGS 0 - 15 . 
AC4C4C4C OOFBBOEO OOFBB110 00000030 803DFDC4 00000006 00000000 803DF310 
OOSIEBCO 00000000 OOFC1908 OOFACO0O O03DEE10 OO3DFE10 8036603A 00365E78 
CONTROL REGS 0 - 15 
9OBOEE40 OOFACOO1] O0000000 00000000 0000000 OOQQO00O FDEOLODD OOO00000 
QOODNO0DN QOODOO0DN OOOQOOOON OGO00000 OOFFIF81 Q0000000 5FOQQ0D00O 00000000 
FLOATING POINT REGS 0 - 6 
90000000 00000000 00000000 90000000 


00000000 00000000 90000000 90000000 


TOD CLOCK 9D31A16B 56129660 
CLOCK COMPARATOR 9D31A173 8CD33E00 
CPU TIMER FFFFFFFF 71A36000 


EXT OLD 03001000 803AEC20 INT CODE 1005 EXT NEW Q00CO000 80364E70 


SVC OLD 900C2000 80366514 INT CODE 0000 SVC NEW Q00C0090 803B6D80 
PGM OLD 000C2000 803A0070 INT CODE 0016 ILC 0004  PGM NEW 000C0000 80390440 
MCH OLD 00000000 00000000 MCH NEW 00080000 80387340 
T/0 OLD 030C1000 8OQ3AEADC T/O NEW O00COO00 80375728 


====> 


Figure 16. Checking the Control Block Identifier with the REGS Subcommand 


5. Examine the FREEEFLG and verify that it contains four less-than signs 
(<<<<). 


In the header, the contents of FREESIZE is 00000006, which matches the length of 
the free storage returned (FRET) in the trace table entry, and FREESFLG contains 
(>>>>). 


In the trailer, FREEEFLG contains (<<<<). 


The contents of FREEID in the trailer is 004C4C4C. It does not match the contents 
of register 0 (4C4C4C4C). This is the cause of the FREO16 abend. 
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Step 4: Summarizing the Dump Analysis 
You have now determined the immediate cause of the FREO16 abend. Your next 
step is to search for duplicate problems at your installation to make sure the 
problem has not already been resolved. If no duplicates are found, contact the IBM 
Support Center to report the problem and its symptoms. You can summarize the 
symptoms in this dump as follows: 


1. Immediately prior to the FRE016 abend, HCPGRF + X'FB4' was trying to 
FRET a variable length control block. 


2. HCPFRE checked the free-storage trace fields and determined that the control 
block identifier in the free-storage trailer did not match the one from the control 
block identifier table (RO). 


3. The free storage header and free-storage trailer doublewords were all valid 
except for FREEID. 
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Chapter 3. Command Reference 


This chapter contains reference information for the dump viewing facility commands. 
The description of each command includes format, operands, return codes, options, 
and responses, if any. Where applicable, usage notes further describe the character- 
istics of the command. For information on messages, see Chapter 5 of this manual. 
You enter dump viewing facility commands from a terminal attached to a CMS 
virtual machine. 


Notational Conventions 


The notations used to define the command syntax in this publication are as follows: 


Commands and subcommands are shown in uppercase and lowercase; the upper- 
case letters represent the absolute minimum truncation or abbreviation of the 
command or keyword operand that the dump viewing facility accepts. 


An operand that contains all lowercase characters indicates a variable value you 
supply. For example, for the operand “fn” you replace “fn” with a filename. 
For the operand “raddr” you replace “raddr” with the desired real address. 


Where multiple operands are shown between braces { }, you must select one 
operand. 


Where operands are shown between brackets [ ], you may choose one unless oth- 
erwise specified. 


An operand that is both enclosed in brackets and underscored indicates that the 
system will default to the bracketed underscored operand unless you specify 
another one. 


In all syntax descriptions, fm and filemode are interchangeable. 


Command Reference 


The dump viewing facility commands are described here in alphabetical order. For 
further information on messages issued by the various commands, refer to Chapter 5 
of this manual. 
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ADDMAP Command 
Use the ADDMAP command to resolve the address of each pageable CP module in 
real storage at the time of the dump, and to append the resolved module map to the 
dump file. For virtual machine dumps, use the ADDMAP command to append 
virtual machine module maps. 


The format of the ADDMAP command is as follows: 


ADDMAP fileid XXXXXXXX 


Where: 


fileid —_— 
is the filename, filetype, and filemode oh the input CMS file containing the dump NO 
viewing facility module map. 


XXXXXXXX 
is the name of the CMS file containing the dump to be processed, where 
XxXxXxXxXxxx is a 1- to 8-character string containing any combination of the charac- 
ters 0-9, A-Z, @, #, -, _, +, :, and §. 


fm 
* 


is the filemode of the CMS file containing the dump to which the dump viewing 3 
facility module map will be appended. 


Usage Notes: 


1. Due to the limited amount of modules in a soft abend dump, the ADDMAP 
command is not supported for soft abend dumps. 


2. The ADDMAP command will resolve pageable addresses for CP hard abend 
and standalone dumps only. 


3. In case you add an incorrect map to a dump, the ADDMAP command can be 
invoked again to add the correct map to the dump. | 


4. In order to use the ADDMAP command, the load map must first have been 
processed by the MAP command. If this has not been done, refer to the MAP 
command description in this chapter. 


5. The dump file (xxxxxxxx) must have a filetype of DUMP; if 1t does not, you 
may rename the file appropriately using the CMS RENAME command. If the 
dump filename is not specified, you are prompted to enter one. 


If the filemode is not specified, or an asterisk (*) is specified, the system uses the 
standard CMS search sequence. 
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Examples: 


You want to resolve and append to dump ABEND003 DUMP AI a processed 
module map called CPLOAD MAPA AI. To do this, enter the following: 


addmap cpload mapa al ABENDOO3 al 
The result is the ABEND003 dump with the CPLOAD module map appended to it. 
To resolve and append to dump DUMPUSER DUMP AI a processed module map 


with the default name for a CMS dump, enter: 
addmap cmsdvf map al DUMPUSER al 


For more information on the default map names, refer to the MAP command. 


Return Codes: 


( ; RC Explanation 
| 0 Successful completion 
20 Invalid fileid 
24 Command line error 
28 CMS file does not exist 
32 Invalid data in file 
on 36 Disk not accessed 
( | 41 Insufficient storage 
100  FSREAD/PRINTL error 


104 Internal processing error. 
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DUMPSCAN Command | | 
Use the DUMPSCAN command to initiate a session to interactively analyze and hd | 
debug problems in a dump. Once you start a session, use the various DUMPSCAN WY 
subcommands as described in Chapter 4. The DUMPSCAN command also dynam- 
ically creates and appends a CP module map to a CP dump. 


The format of the DUMPSCAN command is as follows: 


DUMPSCAN 


Where: 


XXXXXXXxX | 2 vi 
is the name of the CMS dump file to be processed, where xxxxxxxx is a 1- to 
8-character string containing any combination of the characters 0-9, A-Z, @, #, 
-,_, t+,:, and §. 

fm 


* 


is the positional operand specifying the filemode of the desired CMS file con- 
taining the dump. 


Usage Notes: 


1. The dump file must have a filetype of DUMP; if it does not, you must rename 
the file appropriately using the CMS RENAME command. 


If the filemode is not specified or an asterisk (*) 1s specified, the system uses the 
standard CMS search sequence. 


2. If the DUMPSCAN command is entered with no operands, you are prompted to 
enter the desired dump filename (and optionally the filemode). 


3. In order for DUMPSCAN to build and append a CP module map, the dump to - | ; 
which you want the module map appended must be on a disk to which you have iar 
write access. Furthermore, the dump must not have a map already appended to 
It. 

4. The DUMPSCAN subcommands FRAMEtbI (FRMtbl), RIOblok, VIOblok, 

FINDUSER, and FINDMod are not supported for soft abend dumps. 
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Return Codes: 


RC Explanation 

0 Successful completion 
20 Invalid fileid 

24 Command line error 

28 CMS file does not exist 
32 Invalid data in file 

36 Disk not accessed 

41 Insufficient storage 
100 FSREAD/PRINTL error 


104 ~=Internal processing error. 
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MAP Command 


Use the MAP command to convert a CP nucleus load map or a virtual machine load ff 
map into a format that the dump viewing facility can process. The converted load Ne 
map, which is called the dump viewing facility module map, will serve as input to 
the ADDMAP command. ADDMAP appends the converted load map to the dump 
file, which is created by the VM/XA System Product DUMPLOAD command. 
The MAP command can be invoked in three ways: 

1. You can specify the files to be processed. 

2. You can specify that the default files are to be processed. 

3. You can specify that you be prompted for the files to be processed. 


The format of the MAP command is as follows: 


infilel | infitee | outfile ( | CP 


CMS 
GCs 
NOPrompt PVM 
RSCSnet 
RSCSV2 
PROmpt a: 
Where: 
infilel 
is the filename, filetype, and filemode of the input CMS file containing the 
primary load map. 
infile2 
is the filename, filetype, and filemode of the input CMS file containing the sec- oS 
ondary VM/Pass-Through load map required for PVM dumps. Once the J 


primary CMS nucleus load map (infilel) has been processed, the secondary map 
is processed and included in the module map. 


outfile 
is the filename, filetype, and filemode of the resulting CMS file containing the 
dump viewing facility module map, which is used as input to the ADDMAP 
command. 


CP | 
specifies that a CP load map is to be processed. This is the default. 


CMS 
specifies that a CMS load map is to be processed. 


GCS 
specifies that a GCS load map is to be processed. 


PVM 3 
specifies that VM/Pass-Through load map and CMS load map are to be proc- 
essed. 7 
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RSCSnet 
specifies that an RSCSNET load map is to be processed. 


RSCSV2 
specifies that an RCSCV2 load map is to be processed. 


NOPrompt | 
specifies that prompting will not occur under any circumstances. The default 
input and output fileids will be used as indicated by the type specified on the 
command line. See usage note 3. 


PROmpt 
is the default. It specifies that the user wants to be prompted for the following: 


1. The type of maps to process. The acceptable reply is: 


CP 
specifies that a CP load map 1s to be processed. 


CMS 
specifies that a CMS load map is to be processed. 


GCS 
specifies that a GCS load map is to be processed. 


PVM 
specifies that VM/Pass-Through and CMS load maps are to be proc- 
essed. 


RSCSnet 
specifies that an RSCSNET load map is to be processed. 


RSCSV2 
specifies that an RSCSV2 load map is to be processed. 


null line 
specifies that a CP load map 1s to be processed. 


SUBSET 
enter CMS subset mode. 


HX 
terminate the MAP command. 


2. The fileids of the input load maps and the output module map. The accept- 
able reply 1s: 


filename [filetype [filemode]]| 
filetype and filemode of the input files default to MAP and *, respec- 
tively if not specified. The filetype and filemode of the output file 
default to MAP and A if not specified. 


null line 
use the predefined fileid. See usage note 3. 


SUBSET 
enter CMS subset mode. 


HX 
terminate the MAP command. 
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Usage Notes: 


1. If file ids are used on the MAP command line, VM/Pass-Through requires that 
infile2 be specified, or an error message is issued and command processing termi- 
nates. CMS, CP, RSCSNET, GCS, and RSCSV2 have no required secondary 


maps. Therefore, if infile2 is specifi 


processing terminates. 


ed, an error message is issued and command 


. Prompting messages will not be issued when the user specifies fileids or 


NOPROMPT on the command line. If an error occurs or a required fileid is not 
specified, an error message is issued and command processing terminates. 


Type Input Map Names 

CP CPLOAD MAP * (nucleus) 
CMS CMSNUC MAP * (nucleus) 
GCS GCSNUC MAP * (nucleus) 
PVM CMSNUC MAP * (primary) 

PVM MAP * (secondary) 

RSCSNET | RSCSNET MAP * 

RSCSV2 RSCSV2 MAP * 


Return Codes: 


100 
104 


Explanation 
Successful completion 
Invalid fileid 


Command line error 


. The following are the default map names used when fileids are not specified: 


Output Map Names 


HCPXADVF MAP A 
CMSDVF MAP A 
GCSDVF MAP A 
PVMDVF MAP A 


RSCSDVF MAP A 
RSV2DVF MAP A 


Missing files or file already exists 


Invalid data in file 
Disk not accessed 

Insufficient storage 
FSREAD/PRINTL failure 


Internal processing error. 
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PRTDUMP Command 


Use the PRTDUMP command to print summary information about the major 
system control blocks and data areas of the dumped system. The PRTDUMP 
command also dynamically creates and appends a CP module map to a CP dump. 


Use the summary reports to assist in problem analysis. Each summary report is 
designed as a reference to information in the dump. You refer to it when interac- 
tively viewing a dump using the DUMPSCAN command, or when examining a 
hexadecimal dump printed by the VM/XA SP DUMPLOAD command. 


Note: For more information on obtaining a printed dump in hexadecimal and 


EBCDIC, see the VM/XA SP CMS Command Reference. 


The printed summary information for control blocks includes key fields rather than 
the entire block. The data and flags are interpreted and a text description provided 
wherever possible. Only control block data that is used most often for debugging is 
presented. 


Using the dump viewing facility PRTDUMP command, you can print these 
summary reports: 
¢ Symptom Records 


The dump symptom record contains information that indicates the state of the 
system when the dump was taken. The printed information is in the same format 
as output obtained through the SYMPTOM subcommand of DUMPSCAN. 


e General Processor Information 


This report contains information that describes the processor(s) associated with 
the dump. This report includes: 


— Registers 

— Clocks and timer 

— CPU address and prefix register 
— Program status words (PSWs). 


For System/370 virtual machine dumps, the general processor summary report 
will also include: 


— Channel status word (CSW) 
— Channel address word (CAW) 
— Interval timer 
— Current PSW. 
* Dump Viewing Facility Module Map 


Module and entry point names and their addresses in the dump are printed for 
all modules that were in real storage when the dump was taken. 
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e Frame Table 


The frame table summary report describes the use and status of all pages of real a 
storage at the time the dump was taken. " 


The frame table is a series of contiguous 4K-byte pages containing one 16-byte 
entry for every 4K-byte page of real storage. The frame table summary report 
describes the use and status of all pages of real storage at the time the dump was 
taken. Each printed summary report contains: : 


— Real storage page number 
— Address of the frame table entry 
— Contents of the frame table entry 
— Frame use. 

¢ DUMPID 
— Only valid for VM dumps. 

¢ Real I/O Control Blocks | | f 4 


This report summarizes all real devices in the system. The report includes device 
and subchannel numbers, device class and type, and key status indicators. 


e Trace Table 


This report contains trace table entries in the order of creation from the oldest 
to the most recent. If the dump is of a multiple processor system, the trace tables 
of the different processors are merged according to the time-of-day (TOD) clock 
values. 


e Virtual Machine List | 2 


A summary of the information in the virtual machine definition block 

(VMDBK) is printed for each virtual machine that was logged on (that is, on the © 
global cyclic list) to the system at the time of the dump. The printed summary 
includes the virtual machine’s mode (370, XA, V=R, V=P), the virtual 

machine’s userid, and various status indicators for each virtual:machine. 


e Virtual Machine User Summary 


This summary report is printed for each virtual machine requested through the — 
PRTDUMP command. This summary includes virtual device data, active I/O ae. 
indicators, and additional information from the VMDBK. 


e Virtual Machine Dump Specific Summary Reports. 


See Appendix E for more information. 
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The format of the PRTDUMP command its as follows: 


PRTDUMP XXXXXXXX 


FRMtb USER userid... 


FRAMEtb1 
MAP 
RIOb1 ok 
Trace 
Vindbk 
DUMPID 
ALL 


Where: 


XXXXXXXX 
is the positional operand specifying the filename of the CMS file containing the 
dump to be processed, where xxxxxxxx is a 1- to 8-character string containing 
any combination of the characters 0-9, A-Z, @, #, -, _, +, :, and $. 


fm 
is the positional operand specifying the filemode of the CMS dump file. If the 


filemode is not specified, or an asterisk (*) is specified, the file is searched for 
using the standard CMS search sequence. 


( 
indicates that PRTDUMP operands will follow. If the (1s specified with no 
operands following, ALL is the default. If (is not specified and operands follow 
the filemode, they are treated as invalid operands. If nothing follows the 
filemode, ALL is the default. 

FRAMEtbI/FRMtb 
specifies that the frame table summary should be printed. 

MAP 


specifies that the dump viewing facility module map that is appended to the 
dump should be printed. For CP dumps only, if a load map is not currently 
appended to the dump, one is built dynamically and appended. However, the 
dump file must be on a CMS disk to which you have write access. 


RIOblok 
specifies that the real I/O control blocks summary report should be printed. 


Trace 
specifies that the trace table summary report should be printed. 


Vmdbk 
specifies that the VMDBK summary report should be printed. 
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‘DUMPID 


ALL 


specifies that the dumpid of the virtual dump should be printed. This option 
only applies to virtual machine dumps. 


specifies that all applicable reports should be printed for the dump type. For CP 
dumps, these include the frame table, module map, real I/O control blocks, trace 
table, and VMDBK summary reports. This is equivalent to specifying the oper- 
ands FRMTB, MAP, RIOBLOK, TRACE, and VMDBK on the command line. 
If no summary reports, including a USER summary report, are requested by 
their keyword operands, ALL 1s the default. 


For virtual machine dumps, ALL specifies that symptom record data, general 
processor information, DUMPID, and the module map be printed. ALL is 
equivalent to specifying MAP and DUMPID on the command line. If no oper- 
ands are specified, ALL is the default. 


USER userid 


specifies that the virtual machine summary report should be printed for the 
virtual machine (userid) specified. Each userid must be preceded by the USER 
keyword. 


Usage Notes: 


1. 


The FRAMEtbl (FRMtb), RIOblok, Trace, USER, and Vmdbk operands of the 
PRTDUMP command are not supported for virtual machine dumps. The 
FRAMEtbIi (FRMtb), RIOblok, and MAP operands of the PRTDUMP 
command are not supported for soft abend dumps. 


. The dynamic map build capabilities for the PRTDUMP command apply to CP 


hard abend and standalone dumps. Dynamic mene build capabilities are not sup- 
ported for soft abend dumps. 


. In order for PRTDUMP to build and append a CP module map, the dump to 


which you want the module map apEeners must be on a disk to which you have 


write access. 


Furthermore, the dump must not have a map already appended to it. 


. If you enter the PRTDUMP command without any operands, you will be 


prompted to enter the dump filename and the filemode, or HX to end proc- 
essing. After you respond to the prompt, the summary reports will be printed. 


This is equivalent to entering the ALL operand, which is the default. 


. If the filemode is not specified, or an asterisk (*) is specified, the system uses the 


standard CMS search sequence. 


. The symptom record summary and general processor information summary 


reports are printed for every valid invocation of the PRTDUMP command. 
They are the first reports to be printed. 


. If you want USER summary reports for more than one virtual machine, the 


USER operand may be specified more than once. The VIO portion of the 
USER summary report 1s supported. 


You can use the USER operands with other keyword operands. For example, 
the following is valid: 3 


prtdump 12345 (user userid1 frmtb user userid2 map 


4 Dump Viewing Facility Operation Guide and Reference 


FO en ar OT OE Sr 


This will result in the following summary reports being printed: 


e 


@ 


The symptom record summary 

The general processor information summary 
The frame table summary 

The dump viewing facility module map 


The user summaries for userid] and userid2. 


If a user summary report is desired in addition to all other summary reports, you 
must specify both the USER and ALL operands. For example, if you enter: 


prtdump dumpuser (user userlawc al] 


You will get: 


© 
® 
® 
® 
e 
t 
®e 


in 


The symptom record summary 
The general processor information summary 
The frame table summary 
The dump viewing facility module map 
Real I/O control blocks 
The trace table 
VMDBK summary reports. 
addition to a summary report for user USERLAWC. 


8. FRAMETBL is an equivalent operand to the FRMTB. The FRAMETBL form 


of 


this operand may be truncated to a minimum of FRAME. 


9. The heading “FRAME TABLE SUMMARY FOR DUMP xxxxxxxx” appears 


at 


the top of each page of the summary report. 


10. If the dump symptom record is missing or not readable, an error message is 
issued and you will be prompted to continue dump processing. 


Return Codes: 


RC 


100 
104 


Explanation 


Successful completion 


Invalid fileid 


Command line error 

CMS file does not exist 
Invalid data in file 
Disk not accessed 
Insufficient storage 
FSREAD/PRINTL error 


Internal processing error. 
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TRACERED Command 7 ; 


Use this command to process trace data recorded by the TRSOURCE command in 
system trace files as well as CP system trace tables records on tape or system trace 
files. TRSOURCE command data ean be merged with CP data or with other 
TRSOURCE command trace data to produce CP data or with TRSOURCE 
command trace data to produce a consolidated output file in chronological sequence. 


The format of the command is as follows: 


idl —[id2...id5] 

NAME fni[,id1]( [{NAME fn2[,id2]}..{NAME fn5[,id5]}] 
DEV vdev 

TAPn 


TRACERED 


CMS fname [ ftype [ fmode | | 
GTRACE 


PRINT [A ] 


OPTIONS: 


HEX ALL LRECL { 80 \ 
FORMAT SELECT 1132 


Where: 
idl 
specifies the primary input to TRACERED from an input system trace file con- 


taining CP or TRSOURCE data. The spool ID, id/, is a decimal number from 
1 to 9 999. 


NAME fnl [,id1] 
specifies the primary input to TRACERED from the filename containing CP or 
TRSOURCE data. The TRSAVE command creates and names a file called fn. 
The parameter, id1, identifies an input system trace file created for fnl. The 
parameter, idl, is specified as a spoolid, a decimal number from 1 to 9 999. a 


DEV vdev | Su 
specifies the primary input to TRACERED from the virtual device address of a 
tape containing CP trace table data. See the VM/XA SP CMS Command Refer- 
ence for a list of supported virtual tape devices. 


TAPn 
specifies the primary input to TRACERED from the symbolic tape identification 
(TAPn) or the virtual device address of a tape containing CP trace table data. 
See the VM/XA SP CMS Command Reference for a list of supported TAPn 
values. 


[id2..id5] 

NAME {fn2[,id2]..NAME fn5 [,id5] 
identifies up to four additional system trace files or filenames containing CP or 
TRSOURCE trace data that are to be merged with data from the primary file. 
The output is merged by time-of-day and formatted as it is written to a CMS file 
or the virtual printer as designated by this command. 


id2..id5 identifies a spoolid or spoolids which must be decimal numbers from 1 
to 9 999. | 
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NAME fn2{,id2] .. NAME fn5 [,id5] 
identifies the filenames created by the TRSAVE command. The identification 
( ,1d2..,id5 is for input system trace files created for fn2..fn5 and is specified as a 
spool ID, a decimal number from | to 9 999. 


CMS fname [ftype [fmode]] 
indicates that the output of the TRACERED command should be directed to a 
CMS file of the filename, filetype, and filemode you specify. If you do not 
specify a filetype, the default is CPTRACE. If you do not specify a filemode, 
the default is A. 


GTRACE 
specifies that the output will be in the form of an OS QSAM file. Only 
GTRACE records recorded by GCS are output to this file. 


PRINT 
designates the output of the TRACERED command to go to your virtual 
printer. This is the system default. 


ie HEX 
( stipulates that each trace entry selected will appear in hexadecimal format. CP 
: trace table data output is one line per trace entry. The number of lines used for 
TRSOURCE data is variable depending on the entry’s record size. You may 
need to use this option if you want to direct the output to a CMS file and 
limited DASD space precludes using the FORMAT option. 


FORMAT | 
specifies that each selected trace entry will appear in a format applying to either 
CP trace table or TRSOURCE recorded data. This is the system default. Three 
oe lines per trace entry are formatted for CP trace table entries. The number of 
( : , lines of output for TRSOURCE recorded entries is determined by a formatting 
ae routine and the length of the trace record which the originator supplies. When 
the formatting routine is not supplied, the data is in formatted hex. This is the 
system default. 


ALL 
indicates that all trace entries from the specified input tape or system trace file 
are to be selected for output. You are not prompted for selection criteria. 


SELECT 
aor’ signifies that you want selection criteria to be applied to the trace entnes. You 
( are prompted for the selection criteria you want. This is the system default. 


LRECL {80 
{ a 
specifies the record length maximum for the output file. When not specified, 
CMS files default to 80 bytes and print files default to 132 bytes. 


Selection Criteria for the SELECT Option 
If you choose, or allow the system to default to, the SELECT option for the TRAC- 
ERED command, you receive the following prompt: 


ENTER TRACE ENTRY SELECTION CRITERIA, NULL LINE TO END 
SELECTION, OR QUIT TO END TRACERED COMMAND 


If you enter a null line, no selection criteria are applied. As a result, everything is 
traced. 


TIME is the only applicable selection criterion for TRSOURCE data. 
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If you enter selection criteria, you will continue to receive this prompt until you 
enter a null line, thus indicating that entry of selection criteria is complete. Accept- 
able replies to the prompt 010A are: 


1. Any combination of the following keywords and values: 


CODE xxxx xxxx... | 
You may enter up to sixteen 4-digit hexadecimal values representing the trace 
table codes to be selected during data reduction of the input tape or system trace 
file. Leading zeros are required. The last two digits of any code may be speci- 
fied as the character string ** or *. This indicates that you want a range of 
trace table codes. For instance, 15** or 15* would select all trace table entries 
beginning with the hexadecimal digits 15. CODE is valid for CP trace table data 
only. 


VMDBK xxxxxxxx XXXXXXXxX... 

You may enter up to 16 hexadecimal values that represent the VMDBK 

addresses to be used during data reduction of the input tape or system trace file. 

Leading zeros are not required. Each address specified must be in the range of 

hex 0 to 7FFFF000 and on a page (4K-byte) boundary. VMDBK is valid only _ 
for CP trace table data. | | = ff 


RDEV xxxx xxxx... 

You may specify up to 16 hexadecimal values that represent the RDEV numbers 
to be used during data reduction of the input tape or system trace file. Leading 
zeros are not required. Each device number specified must be in the range of 
hex 0 to FFFF. RDEV is valid only for CP trace table data. 


VDEV xxxx xxxx. 

You may specify up to 16 hexadecimal values that represent the VDEV numbers 
to be used during data reduction of the input tape or system trace file. Leading 
zeros are not required. Each device number specified must be in the range of 
hex 0 to FFFF. VDEV is valid only for CP trace table data. 


CPU xxxx xxxx. 

You may seeety aij up - 16 hexadecimal values that represent the processor | 
addresses to be used during data reduction of the input tape or system trace file. 
Leading zeros are not required. Each processor address specified must be in the 
range of hex 0 to 3F. CPU is valid only for CP trace table data. 


TIME mm/dd/yy hh:mm:ss mm/dd/yy hh:mm:ss a. 
You may designate a start/stop date/time for the data reduction of the input Ny 
trace entries. If this option is selected, only trace entries created within the des- | 
ignated date and time range will be processed. You may select only one 

date/time range. All the TIME parameters may be input on the same line. 

TIME is the only valid selection criteria if TRSOURCE entries are being proc- 

essed. 


| CMS — To enter the CMS subset mode. 
. HELP — To invoke the help panel for the TRACERED command. 
. QUIT — To terminate the TRACERED command. 


On & Ww WN 


. A null line — To indicate that you are done entering selection criteria and want 
to end prompting. 


If your immediate response to the prompe is a null line, then all trace entries are 
selected. 
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Usage Notes: 


I. 
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The filename designates a set of system trace files created by one invocation of 
the TRSAVE command. Multiple system trace files may exist with the same 
filename. If you specify a filename as NAME fn, TRACERED processes all 
system trace files with that filename, beginning with the oldest. If you specify 
NAME /fnl ,id1 , TRACERED processes all system trace files with that filename 
beginning with the spoolid idJ. If you specify id, TRACERED processes that 
system trace file only. 


. TRACERED uses the first 2 bytes of each TRSOURCE created entry record as 


the length of that entry. 


. When more than one tape created by the same TRSAVE command is to be 


mounted and processed, they must be processed in chronological order. 


. Use the QUERY TRFILES command to display information about system trace 


files you own, including spool ID, filename, and the time of creation. 


A total of five system trace files can be merged. However, only one CP trace 
table file or tape may be included. Therefore, you may specify: 


¢ One CP system trace table file with up to four TRSOURCE trace files 
¢ One CP tape with up to four TRSOURCE trace files, or 
¢ Up to five TRSOURCE trace files. 

You cannot merge a CP tape or tapes with a CP system trace file. 


The following guidelines apply to your responses to the prompt for selection cri- 
teria when CP trace table data is processed: 


¢ Each time the prompt appears, you may specify any or all of the six 
selection types: CODE, VMDBK, RDEV, VDEV, CPU, and TIME. 


e¢ You do not have to input these values on one line (with the exception of 
TIME) because the prompt for selection criteria reappears until you enter a 
null line or QUIT. 


e You cannot specify more than a total of 16 values per selection type in all of. 
your response lines combined, with the exception of TIME. 


¢ An individual trace entry may or may not contain a field of the same type 
specified in your reply to the prompt for selection criteria. All trace entries 
have a trace code, processor address, and time-of-day field; not all trace 
entries have a VMDBK address, real device number, or virtual device 
number. As a result, there are two main rules that apply to TRACERED 
data reduction: 


— If you specify just one selection type in response to the prompt (CODE, 
VMDBK, RDEV, VDEV, CPU, or TIME) then the trace entries chosen 
for output will have a field for the selection type you indicated and a 
value in the field that matches the value you indicated in your response. 


For instance, your response to the selection criteria prompt may have 
been the following: | 


code 0c32 1000 0100 


In this case, all trace entries with the code 0C32, 1000, or 0100 are 
selected. 
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10. 


\1. 


12. 


13. 


14. 
15. 


— If you specify more than one selection type in response to the prompt 
(some combination of CODE, VMDBK, RDEV, VDEV, CPU, and 
TIME) then the trace entries chosen for output depend on the selection 
type fields a given trace entry contains. Trace entries that contain fields 
for only some of the selection types you indicated, but whose values in 
those fields match the values you designated, are chosen for output. A 
trace entry does not have to have all the selection types you specified in 
order to be chosen for output. 


For example, your response to the selection criteria prompt may be the 
following: 


code 0c32 rdev 399 vdev 191 code 1000 0100 


In this case, trace entries to be selected for output depend on the 
following: 


— Trace entries with code 0C32 contain both an RDEV and VDEV 
value. Therefore, a trace entry of 0C32 must have an RDEV field 
value of 399 and a VDEV field value of 191 in order to be selected 
for output. 


— Trace entries with code 1000 contain only an RDEV value. The 
VDEV selection value does not apply in this situation. Therefore, 
all trace entries of code 1000 with an RDEV field value of 399 are 

_ chosen for output. 


— Trace entries with code 0100 have neither an RDEV nor VDEV 
value. Therefore all trace entries of code 0100 are output. 


. The following guidelines apply to your responses to the prompt for selection cri- 


teria when CP and/or TRSOURCE data is requested: 


e If you immediately enter a null line when prompted for the selection criteria, 
this indicates that no data reduction is requested. As a result, all trace 
entries will be selection. 


¢ You can specify a time range only once. 


. If you own more than one set of files with different originators, you must pscily 


NAME fn , id for the file you want. 


. All files being processed must have been created in a VM/XA SP environment. 


Previous trace files not created under VM/XA SP cannot be processed. 
The CMS return code explanation for return code 28 is: 


Tape not attached or output file already exists or system trace 
file not found. 


The format option is supported for CP trace table records, CP records of type 
DATA and IO, and GCS guest trace records. Other guest trace records will be 
formatted in hex output. 


When a new system trace file or tape is being processed, a message will be issued 
to the screen indicating which file or tape is being processed. 


When you indicate VMDBK in your response, data reduction takes place by 
VMDBK address. Should you want to trace a specific user or users, you need 
to find out the VMDBK address for the user in question before invoking the 
TRACERED command. 


For TIME selection criteria, the year YY = 00 defaults to 1900. 


If the HEX option is chosen, all entries will be formatted in hex. 
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. 
Xi 


16. 


When processing system trace files which contain GCS trace entries, it is advis- 
able to use the LRECL 132 option for formatted CMS output. 


Examples: 


I. 


TRACERED 190 CMS TRACE! TABLES A 


TRACERED is specified for one system trace file by spoolid 190. The output 
goes into CMS file TRACE! TABLES A. Selection criteria are prompted. 


. TRACERED 183 194 172 


TRACERED is specified for three system trace files by spoolids 183, 194, and 
172. All defaults are taken. That is, the output is formatted and goes to a 
printer. Selection criteria are prompted. 


. TRACERED 0183 NAME PVMUSER 194 CMS TRACE2 OUTPUT A 


(SELECT 


TRACERED is specified for two system trace files by spoolids 183 and 194 and 
one filename, PYVMUSER. Output goes to CMS file TRACE2 OUTPUT A and 
selection criteria is prompted. 


. TRACERED NAME PVMUSER 194 CMS TRACE? OUTPUT A 


TRACERED is specified for one system trace file by spoolid 194 and file name 
PVMUSER. Output goes to CMS file TRACE2 OUTPUT A and selection cri- 
teria are prompted. 


. TRACERED DEV 182 NAME PVMUSER 194 


TRACERED is specified for one system trace file by spoolid 194 and filename 
PVMUSER. One CP trace tape on virtual device 182 is input. All defaults are 
taken. That is, the output is formatted and goes to a printer. Selection criteria 
are prompted. 


. TRACERED NAME PVMUSER ,100 


TRACERED is specified for one filename, PYMUSER. Processing will start 
with spoolid 100, which identifies a system trace file within filename 
PVMUSER. All defaults are taken. That is, the output is formatted and goes 
to a printer. Selection criteria are prompted. 


. TRACERED NAME PVMUSER ,100 RSCS ,2000 


TRACERED is specified for two filenames, PYVMUSER amd RSCS. Processing 
for PVMUSER will start with spoolid 100 and processing for RSCS will start 
with spoolid 2000. 100 and 2000 identify system trace files within filenames 
PVMUSER and RSCS. All defaults are taken. That is, the output is formatted 
and goes to a printer. Selection criteria are prompted. 


. TRACERED NAME RSCS ,2000 500 


TRACERED is specified for one filename, RSCS, and for one system trace file 
by spoolid 500. Processing for RSCS will start with spoolid 2000. All defaults 
are taken. That is, the output is formatted and goes to a printer. Selection 
criteria are prompted. 


. TRACERED 190 CMS TRACE! (LRECL 132 


TRACERED is specified for one system trace file by spoolid 190. The output 
goes into CMS file TRACE] CPTRACE A and the record length for the output 
file will be 132 bytes. Selection criteria are prompted. 
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10. TRACERED 190 (LRECL 80 


TRACERED is specified for one system trace file by spoolid 190. The output is fo 
formatted and goes to a printer. The record length for the output file will be 80 
bytes. Selection criteria are prompted. 


TRACERED Output 


There are four types of output you may generate from the TRACERED command: 
a formatted CMS file, a formatted print file, an unformatted CMS file, or an unfor- 
matted print file. 


Note: You may encounter storage constraints if you select a CMS file for the 
output. The more trace entries that meet the selection criteria, the larger the 
storage requirements. 


One way to alleviate storage constraints is to designate more stringent selection cri- 
teria. : 


Formatted CMS File 
When you select the FORMAT (the default) option and designate a CMS file in the 
TRACERED command, the default setting of the output to the CMS file consists of 
80-character fixed-length records. You can reset the default record using the 
LRECL option. 


CP Trace Table Output: Each CP trace entry selected comprises three output lines: 


¢ The first line contains the trace code, the CPU address, a description of the type 
of entry, and the time the entry was created. 


¢ The second and third lines describe the trace entry data contents, which vary 
according to the type of entry. 


0600 CPU 0000 OBTAIN FREE STORAGE (FREE) TIME 19:26:31 
BLOCK ID DOUBLE WORDS BLOCK ADDR VMDBK ADDR RETURN ADDR 


<IOR 00000020 OOFC5EAS Q0O0FB1000 004CF922 


Figure 17. Formatted CP Trace Entry 


Each time TRACERED encounters a missing CP data record, the following line 
appears in the CMS file: 


CPU xxxx - TRACE DATA HAS BEEN LOST 


A blank line precedes and follows the lost data line in the CMS file. Processing 
continues with the next available trace entry. 


Processing Input Tapes: Each time a new input tape is processed, a header record 
is written that contains the volume sequence number and the creation date and time 
of the TRSAVE tape. Also at the time a new input tape is processed, that same 
information is displayed at your terminal screen. Informational message 030I (see 
page 163) indicates the volume sequence number of the current TRSAVE input trace 
tape and the date the tape was created. 


Note: This message does not indicate that the dump viewing facility has finished 
processing. It continues processing the input tape. 
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Guest Trace Output (GCS): Each GCS trace entry processed by TRACERED is 
sent to a GCS routine, CSIYTD, to be formatted for output. An example of for- 
matted GCS output follows: 


3D OE NET VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = 9A6266195A8E2C00 
LENGTH OF GTF HEADER AND TRACE DATA =0017 


FORMAT ROUTINE ID = FD 
EVENT IDENTIFICATION = EFE1 


Figure 18. Guest Trace Data of Type GCS 


Other Types of Guest Trace Output: TRACERED formats other guest trace data 
and produces the following information per trace record: 


e The time the entry was created. 
¢ The contents of the trace entry in hexadecimal (up to 20 bytes per line). 


e¢ The string SPID followed by a decimal number. This identifies the system trace 
file from which the entry was obtained. 


An example of other types of guest trace output formatted by TRACERED follows: 


16:23:10 O201AEDO 085F7400 000C1000 O002Z25BA2 OOO1BDEO SPID 1000 


02025BA2 OC5F7400 


Figure 19. Other Types of Guest Trace Output Formatted by TRACERED 


1/O Trace Entry Output: TRACERED recognizes I/O data trace information. An 
example of a formatted I/O data trace entry follows: 


TRACE TYPE 10, CPU 0000 TIME 01:00:00 
TRACEID - 101, TRACESET = IOSET, IODATA = 12 | 
USER - TIMR, I/0 OLD PSW = 033E0000 803973C8 
DEVICE = 0570, SCSW = 00404007 OQ05D10B0 OCQ00001 

->CCW(1) = 4B000000 60000001, CCW ADDRESS = 005D1088 
->CCW(2) = 015D1050 AQ000001, CCW ADDRESS = 005D1090 
DATA = C2 4 
->CCW(3) = O05CE2F5 AQQ00047, CCW ADDRESS = 005D1098 
DATA = 1101E028 41002842 OOF1F57A 

->CCW(4) = 005D1058 6000002D, CCW ADDRESS = 005D10A0 
DATA = 29034200 4100COQC1 11E76B29 ae ec Rohge” 
->CCW(5) = 03000000 20000001, CCW ADDRESS = 005D10A8 


Figure 20. I/O Data Formatted by TRACERED 
Data Trace Entry Output: TRACERED recognizes CP data trace information. 


An example of a CP data trace entry output formatted by TRACERED follows: 
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BCCI tay aR SORES TAs OCT SOE EE LERE CUE SEL TRAE RE CORON ES IL See OLE 


TRACE TYPE DATA, CPU 0000 TIME 16:06:07 f 
TRACEID = Q, TRACESET = NULL, ADDRESS = 0061A058 We 
-> DATALINK STRING 1 = G11.090=VMDBK 
DATA = OOBDCOOF OOA9EOOF QOASDOOF OOASCOOF * 
QOAQBOOF OOAIAGOF OOAIIOOF OOA98OOF * 
QOA97OOF OOAIGOOF OOAISOOF OOA94Q0F * 
QOA9300F OGAB500F OOBC8OOF OOAC7OOF *. 
80000020 80000020 80000020 80000020 *.........eeeeees 
80000020 80000020 80000020 80e00020 * 
80000020 80000020 80000020 80000020 * 
80000020 80000020 80000020 QOAAQOOO *.............05. 
D6D7C5D9 C1E3D6D9 D6D7C5D9 C1E3D6D9 *OPERATOROPERATOR* 
-> DATALINK STRING 2 = G10.100=HCPTXCCM 


eee#eoeneee#teoe#tsteee#esee se 


N 
(20 
+ + + FF FF FHF HF 


DATA = FFFFFFFF FREFFFFF FRFFFFEF FRFFFFFF *......ccnveccces r 
Q30CO000 8O3A30F2 OOOC2000 8ODEBO5A *....... Cates 
000C1000 8047865C OO000000 GQO00000 *...... CP agian - 
030C1000 804631FO O0000000 OOOOOOOO *....... Oecca aaa _ 
00OH0000N OHNOOODOO OHOOHODON OOOHOOOOO *................ - 
QO0COO00 803B1060 OOOCOO00 80478060 *....... Se 
QOOCOONO 804A0230 00080000 80401170 *..... Cxoiersiness tes rt 
QOOCOOOO BO3DCCF8 0O33E000 00001004 *....... Oreraceas : 
Q0002001C 00040016 QODES5888 OOOOO0OO. *........... Neseet 
90000000 80000000 OOOQ0000 OQODO0CO *................ i 
OCO0O0DO HOOOEOLO OOOOOOOO OOOOOOOO *................ * 
00010001 00327240 QOD00000 OOOOODOO *....... ........ i 
QOOD0HNN HOODODOO OOOHOOOO OOOOOOOO *................ is 
00000000 OOQDODON HOOOOOOO OOOOOOOO *................ . & 
QOONO000N ONOEOONON OOOHONON OOOOOODO *.............4.. . _ 3 
QO0NHH0N HOQDODOO HOODOQOO OOOOOOOO *................ * oe 


Figure 21. Data Trace Entry Output Formatted by TRACERED 


Formatted Print File 
TRACERED formatted print output is identical to formatted CMS file output 
except that the default record length is 132 bytes. The TRACERED output is ie 
directed to your virtual printer rather than to a CMS file. \ 


Unformatted CMS File 7 
When you select the HEX option and designate a CMS file in the TRACERED 
command, the default setting of the output to the CMS file consists of 80-character 
fixed-length records. You can reset the default record using the LRECL option. 


CP Trace Table Output: Each CP trace entry selected comprises one line. The line 
contains the processor address, the time the entry was created, the trace code, and 
the trace entry data contents. These are in hexadecimal format. 
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CPU = TIME. «= CODE. **##****** TRACE ENTRY CONTENTS **#*# #4 ex oH 


05/31/88 


0000 11:51:21 3310 £4C34040 00000001 OOFACOQO OOFFBA80 005311E0 SPID 0003 


Figure 22. CP Trace Table Output 


Other Trace Types: TRACERED processes other traces (I/O, CP data, guest trace) 
and produces the following information per trace record: 


e The time the entry was created. 
¢ The contents of the trace entry in hexadecimal (up to 20 bytes per line). 


ee ¢ The string SPID followed by a decimal number. This identifies the system trace 
( | file from which the entry was obtained. 


An example of unformatted trace data output follows: 


16:23:10 OZ01AEDO 085F7400 O00C1000 OOO25BA2 OQO1BDEO SPID 1000 


02025BA2 OC5F7400 


( | Figure 23. Guest Trace Output 


Unformatted Print File 
TRACERED hexadecimal print output is identical to hexadecimal CMS file output 
except that the default record length is 132 bytes. The TRACERED output 1s 
directed to your virtual printer rather than to a CMS file. 


CMS Return Codes 
pe When the trace reduction process is complete, the dump viewing facility returns one 
( of the following codes to CMS: 


Return Codes: 


RC Explanation 


0 Successful completion 
4 No trace entries meet the selection criteria 
20 Invalid character in output fileid 


24 Command syntax error 


28 Tape not attached or output file already exists or system trace file 
is not found 


36 Disk not accessed 


41 Insufficient virtual storage 
106 = 1/0 error. 
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Chapter 4. DUMPSCAN Reference 


This chapter contains reference information for the DUMPSCAN subcommands 
used to interactively view data from a dump. It also contains XEDIT services that 
can only be used within an EXEC. 


XEDIT Services 


The following table lists all the XEDIT services that can be used only from within a 
macro. The syntax for these services is documented first in this chapter. 


FINDSitrg Search for a particular string of data in the dump while you are still in an 
EXEC 

NOTE Send text output to the dump viewing facility to be displayed on the ter- 
minal, printer or both 

READStrg Read data from the dump, via a direct or indirect address, while in an 
EXEC 

SCAN Process a PF key assignment or command string to the system product 
interpreter. 


Figure 24. XEDIT Services Only Used within a Macro 


DUMPSCAN Subcommands 


The following table lists all the subcommands for DUMPSCAN. The minimum 
truncation for each command is indicated by the uppercase letters in the subcom- 
mand column. All subcommands are valid for CP hard abend and stand-alone 
dumps except DUMPID, VPAIR, VREG, and VSTAT. Reference information on 
these subcommands follows XEDIT services in this chapter. 
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(null line) Enter a null line to continue the previous CHAIN, LOCATE, 
| ? LOCATEUP, BACK WARD, or FORWARD subcommands 
+ (plus symbol) - (minus Increase forward through hexadecimal data or trace entries; decrease | 
symbol) backward through hexadecimal data or trace entries 
& (ampersand) Assign symbolic names to subcommands 
or &name | 


i 
t 
‘ 
| 
| 
| 
| 
i 
i 
H 
i 
: 
: i 
I 
i 
i 
i 
| 
| 
| 
i 
j 


CMS Enter the CMS subset mode | . - 


CPU Display the address and prefix register values for each processor 


FINDMod Display the displacement and module name or entry point, given an a. 
address; or display an address, given a module name or entry point Neey a? 


FINDUSER Display the active save areas and VMDBK status for a specified userid 
Forward Scroll forward through hexadecimal data or trace entries 


FRAMEtbl Display the frame table entry for the specified address 
or FRMtbl | 


Gregs Display general purpose registers for the specified processor 


HELP | Display individual DUMPSCAN help files or the menu that lists all the 
DUMPSCAN help files 


an 
* 


Exit from the DUMPSCAN command and return to CMS 


Locate Locate the next occurrence of a hexadecimal or character string in a dump 


LocateUp Locate the previous occurrence of a hexadecimal or character string in a 
dump 


Figure 25 (Part 1 of 2). Subcommands for DUMPSCAN 
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Subcommand Description 


( - Print Direct output of the subcommand to the printer 
~ or PRT 


QUIT Exit from the DUMPSCAN command and return to CMS 


Regs Display registers, clocks, timer, and program status words for a specific 
processor 


RIOblok Display data about real I/O devices 
SELect Specify trace table display criteria 


SNAPIist Display a summary snap list in a soft abend dump 


SYMPtom Display symptom record data 
Trace 


VIOblok 


( . Vmdbk Display data about one or more virtual machines 


VPair Display the contents of a vector register pair or a designated number of 
vector elements 

VReg Display the contents of a vector register or a designated number of vector 
elements 


VStat Display Vector Facility status information, if applicable, for any processor 
found in a VM dump 


( XEDIT Pass the command line to XEDIT for execution. 


Figure 25 (Part 2 of 2). Subcommands for DUMPSCAN 


Display trace table entries 


Display data about virtual I/O devices for a specific virtual machine 


Each of the following subcommand descriptions include the subcommand syntax, 
keywords, operands, and options. Where applicable, the descriptions also include 
usage notes, examples, or samples of the output to be expected from each subcom- 
mand. 


oo The same notational conventions apply to the DUMPSCAN subcommands as 
( | described in “Notational Conventions” in Chapter 3. 
General Usage Notes: 
1. All addresses in this chapter refer to real addresses unless otherwise specified. 


2. All dump storage addresses are 31-bit, 4-byte addresses containing 1-to-8 
hexadecimal characters unless otherwise specified. Leading zeros can be 
omitted. For example, if you want to enter address 00012F31, you may enter 
00012F31 or 12F31. 


3. All processor addresses (cpuaddr) are |- to 4-byte hexadecimal digits. 
4, All device numbers are 1-to-4 hexadecimal digits. 


5. Logical real device numbers are 1-to-4 hexadecimal digits and are prefixed with 
the letter L. 
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FINDSTRG Subcommand 


Use the FINDSTRG subcommand to search for a particular string of data in the 
dump while you are still in an EXEC. If found, the address of the string is returned 
in a REXX variable. | 


The format of the FINDSTRG subcommand is as follows: 


FINDStrg | string | fromaddr toaddr increment. 
0 7 FFFFFFF 1 


( VAR name 
RESULT 


Where: 


string 
is a 1- to 8-byte hexadecimal string for which you are searching. 


fromaddr 
is the 31-bit (1-to-4 byte) hexadecimal starting address for the search. If not 
specified, this defaults to start at location 0. Leading zeros are not required. 


toaddr 
is the 31-bit (1-to-4 byte) hexadecimal ending address for the search. If not 
specified, this defaults to end at location 7FFFFFFF. Leading zeros are not 
required. 


increment 
is a 1- to 4-digit hexadecimal number to change the current address after each 
match attempt. 


VAR 
is a keyword operand indicating that the following is the user specified REX var- 
iable name. 


name 
is a 1- to 8-character user-specified name of a REXX variable where the results 
of the FINDSTRG subcommand will be placed. 


RESULT 
is the default name of the REXX variable if you do not specify a name. 
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Xe w 


pho nee 


Usage Notes: 


l. 


This subcommand can only be executed from an EXEC. An error message is 
issued if entered from the command line. 


. Unlike the LOCATE subcommand which accepts either up to 8 EBCDIC char- 


acters or 16 hexadecimal digits, the FINDSTRG subcommand only accepts up 
to 8 hexadecimal digits (4 bytes). If EBCDIC data such as a userid needs to be 
located, it must be converted to hex first. 


. If the “from” and “to” addresses are not specified, they will default to the begin- 


ning and ending of the dump. 


. In order to specify an increment both the “from” and “to” addresses must be 


specified. 


. The address of the first byte of the string, if found, is placed in a REXX variable 


(RESULT or the user-specified name). 


. If the user wants to look for multiple occurrences of a string within a dump they 


must update the fromaddr after each match. The reuse or = subcommands do 
not apply to this subcommand. 


. The valid increment range is from X'1' to X'1000'. 


. The following return codes will be returned to the EXEC: 


0 = Successful execution 
8 = String not found 
16 = Invalid operands 
20 = Internal error. 
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NOTE Subcommand | 
Use the NOTE subcommand to send text output to the dump viewing facility to be | 


displayed on the terminal, the printer, or both. 


The format of the NOTE subcommand is as follows: 


text | PRINT NOTERMINAL 
NOPRINT TERMINAL 


Where: 


text 
is the output to be displayed. This includes any leading blanks. The maximum 
length of the text is 80 bytes. If no text is specified, a blank line is printed or © 
displayed according to the options selected or defaulted. Beginning and ending 
quotes are mandatory if text is specified. 


PRINT 
indicates that the text should be sent to the virtual printer. This operand may 
not be specified in conjunction with the NOPRINT operand. 


NOPRINT 
indicates that the text should not be sent to the virtual printer. This operand — 
may not be specified in conjunction with the PRINT or NOTERMINAL oper- 
ands. This operand is the default. 


TERMINAL 
indicates that the text should be displayed on the terminal. This operand may 
not be specified with the NOTERMINAL operand. This operand is the default. 


NOTERMINAL 
indicates that the text should not be displayed on the terminal. This operand 
may not be specified in conjunction with the TERMINAL or NOPRINT oper- 
ands. 
Usage Notes: 
1. This subcommand is only valid when issued from an EXEC. 


2. Text which is longer than 80 bytes is truncated to 80 bytes prior to being printed 
or displayed. 


3. The following return codes are returned to the EXEC: 
0 - Successful execution. 
8 - Invalid condition such as conflicting operands, or missing end quote. 


500 - Virtual printer error. (A message indicating this error is displayed on the 
terminal.) 
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path SRR 


READSTRG Subcommand 
Use the READSTRG subcommand to read data from the dump while you are in an 


be EXEC. You can specify the actual or an indirect address. The data at that address 
is returned in a REXX variable. 


The format of the READSTRG subcommand 1s as follows: 


RESULT 


READStrg | aes % | length | ( VAR | name | 


( _ Where: 


address 
is the 31-bit (1-to-4 byte) hexadecimal address from which the data is to be 
retrieved in the dump. Leading zeros are not required. 


% 
specifies a 24-bit indirect address. A word (4 bytes) of storage at the specified 
address is read from the dump and used as the basis for a second read. The data 
at the second address is returned to the EXEC. 


7 9 
( / specifies a 31-bit indirect address. A word (4 bytes) of storage at the specified 
address is read from the dump and used as the basis for a second read. The data 
at the second address is returned to the EXEC. 


length 
is an optional operand. It is a 1- to 4-digit nonzero hexadecimal number indi- 
cating the length in bytes to be returned to the EXEC. The valid range 1s from 
X'1' to X'1000'. | 


| ( | is the default length of the data to be returned. 


VAR 
is a keyword operand indicating that the following is the user-specified REXX 
variable name. 


name 
is a 1- to 8-character user-specified name of a REXX variable where the results 
of the READSTRG subcommand are placed. 


RESULT 
is the default name of the REXX variable that is used if the user does not 
specify a name. 


Usage Notes: 


1. This subcommand can only be executed from an EXEC. An error message is 
issued if entered from the command line. 


2. The dump data is translated to EBCDIC and then returned to the EXEC in a 
REXX variable (that is, in the parameter RESULT or the user-specified name). 
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3. If only partial data is available in the dump, READSTRG returns only the 


available data in which case the user should check the length of REXX variable a 
being used. 


4. The following return codes will be returned to the EXEC: 


a) 
| 


Successful execution 
Partial data returned 
8 = Page not dumped 
16 = Invalid operand 

20 = Internal error. 


oN 
I 
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SCAN Subcommand 


Use the SCAN subcommand to process a PF-key assignment or a command string 
from the system product interpreter. 


The format of the SCAN subcommand is as follows: 


subcommand operands | 


Where: 


subcommand 
is any valid DUMPSCAN subcommand 


operands 
includes any operands for the DUMPSCAN subcommand you requested. 


( Usage Notes: 


1. Use the SCAN service to assign dump viewing facility functions to PF keys. For 
more information, see “Assigning Program Function Keys to DUMPSCAN 
Subcommands” on page 19 


2. Use the system product interpreter command ADDRESS to effect a temporary 
or permanent change to the destination of commands. The SCAN environment 
is addressable from any EXEC2, REXX EXEC, or XEDIT macro during the 

poo DUMPSCAN session. For more information, see “What Is an Environment?” 
( on page 16. 
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Null Line Subcommand | 
Use the “null line” subcommand to reissue the previous CHAIN, LOCATE, a ~ 
LOCATEUP, BACKWARD, or FORWARD subcommands. 


waite! 


Usage Notes: 


1. Pressing the ENTER key with no data entered repeats the previous CHAIN, 
LOCATE, LOCATEUP, FORWARD, or BACKWARD subcommands with an 
updated address. 


2. Entering a null line is valid for the CHAIN subcommand only if the number of 
control blocks exceeds 4096. A message is issued when there are more than 4096 
control blocks. Entering a null line continues the chain presentation starting 
with the last address displayed. 


3. The running total of all members found are displayed in the output of the reis- i 
sued CHAIN subcommand. 


Response: 


Using the null line command re-executes the CHAIN, LOCATE, LOCATEUP, 
BACKWARD, or FORWARD commands; a full screen of the appropriate data is 
displayed. 
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. + and - Subcommands 
( . Use the “+” and “-” subcommands to adjust the address pointer and reissue the 
| DISPLAY subcommand. 


Where: 


increment 
is the hexadecimal number to be added to the address pointer of the last dis- 
played subcommand entered. 


For the TRACE subcommand, increment is the decimal number of entries you 
want to move forward. 


( decrement 
is the hexadecimal number to be subtracted from the address pointer of the last 
displayed subcommand entered. 


For the TRACE subcommand, decrement is the decimal number of entries you 
want to move backward. 
Usage Notes: 


ra 1. The “+” and “-” subcommands can be used after the displaying and scrolling 
( subcommands of the dump viewing facility are issued. These subcommands are: 
pap BACKWARD, DISPLAY, FINDMOD, FORWARD, LOCATE, LOCATEUP, 
and TRACE. 


2. Although there is no upper limit to the increment value, the resulting address 
must be within the range of the dump or an error message 1s displayed. 


3. These subcommands do not wrap the screen. 


4. If the OFFSET operand was specified on the previous DISPLAY subcommand, 
then issuing the “+” or “-” subcommand continues to display offsets. 


( 5. When scrolling through trace entries, use the increment or decrement variable to 
specify the number of entries to move forward or backward. 


Response: 


Provided there is a full screen of data left in the dump, an entire screen of dump 
data is displayed with the current line position at the calculated address. 
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&name Subcommand 


Use the “&name” subcommand to create a table of frequently used subcommands 
that may be invoked by another name, or to invoke a subcommand by its other 
name. 


subcommand | 


Where: 


name 
is the symbolic name you give to the subcommand expression entered in the 
&name table. The name portion of this subcommand may be 1-to-7 characters 
in length and must be preceded by the ampersand. 


subcommand 
is the entire syntax of the subcommand including any operands specified. 
Entering “&name” without any operands invokes the subcommand. 


& 
Entering an ampersand (&) alone lists all the table entries. 


Usage Notes: 


1. When entering data into the &name table, you may not enter another “&name” 
subcommand. For example, 


&namel &name2 
is not allowed. 


2. If you try to invoke a &name that is not in the table, DUMPSCAN issues an 
error message. 


3. The subcommand in the table is not checked for validity until it is invoked by 
entering “&name.” Only then are errors detected by the appropriate subcom- 
mand processor. 


4. The PRINT subcommand is not allowed in the &name table. 


5. All entries into the &name table are limited to 8 characters for each operand. 
The “&name” subcommand plus eight operands may be entered, that is, &VM 
VMDBK operand? operand3...... operands. 


6. Up to 64 operands, including the symbolic names (&name), may be contained in 
the &name table at any one time. The number of symbolic names you are 
limited to is determined by the number of operands used per subcommand. You 
can assign more subcommands with three operands (21) than you can with seven 
operands (nine). 


7. If the LOCATE subcommand 1s placed in the &name table, the maximum string 
of 8 characters includes the hexadecimal identifier X, the hexadecimal characters, 
and the quotes (for example, X'13AB4'). 
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Responses: 
1. If &name is entered, the response is from the subcommand executed. 
2. If & is entered, a list of the current entries in the &name table is displayed. 


3. If &name subcommand is entered, the ready response indicates the subcommand 
has been added to the &name table. 


Example: 


The “&name” subcommand 1s useful for command strings that are used constantly. 
It allows you to shorten a command string to one symbolic name. 


Figure 26 illustrates a sequence of six &name entries being made in the &name table 
from the command line. | 


&dn -1000 
&up +1000 


> 
> 

> &lo locate feibm O 7fffffff 
> &d display 6a000 100 offset 
> &ch chain 1000 600 £4000 
> &rio rioblok at 927770 


Figure 26. A Sequence of &name Commands 


After all six entries are made, you can check the &name table by entering the &name 
table list subcommand “&”. This displays the &name table as shown in Figure 27. 
The subcommand entered is: 


& 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
&DN -1000 

&UP +1000 

&LO LOCATE FEIBM 0 7FFFFFFF 


&D DISPLAY 6A000 100 OFFSET 
&CH CHAIN 1000 600 F4000 
&RIO RIOBLOK AT 927770 


===> 


Figure 27. Listing the &name Table 
Any time you wish to execute a command string in the &name table, enter the sym- 
bolic name corresponding to the desired command. The command in the &name 


table is processed as if it were just entered manually. 


Figure 28 shows the symbolic command &rio being entered, and the resulting 
display of the corresponding subcommand, RIOBLOK. AT 927770. 
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The subcommand entered is: 


&rio. 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 
REAL DEVICE O00E SUBCHANNEL 0000 RDEV ADDRESS 00927770 


CLASS = 20 SPOOL FEATURE = @1 

TYPE = 22 3211 PRT MODEL = 00 

USER VMDBK ADDR = 90900000 DEDICATED VDEV ADDR = 00000000 

USER VMDBK USERID = SYSTEM WAIT DEVICE CPEBK ADDR = 00000000 

LOCK OWNER VMDBK ADDR = 00000000 WAITING TASK QUEUE = 00000000 

LOCK OWNER VMDBK USERID RDEVAFLG = 84 

ACTIVE IORBK ADDR = 00000000 RDEVDFLG = 00 

INTERVENTION REQ'D IORBK ADDR = 00000000 RDEVRFLG = 00 

NEXT IMMEDIATE IORBK ADDR = 90000000 RDEVSTAT = 00 

DEVICE DEPENDENT INFORMATION: oN 
RSPBK ADDR = 009269E8 RELATIVE SPDBK NUMBER = 0000 | Co 
ACTIVE SPFBK ADDR = 00000000 ACTIVE FILE ID = 0 ie 
CURRENT SPABK ADDR = 00000000 SPOOL CLASSES =A/ ////// 

RSPFLAG = 88 SILBK ADDR = 00000000 


NO ACTIVE IORBK 


===> 


Figure 28. Executing the RIOBLOK Subcommand Using a Symbolic Name 
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? Subcommand 
Use the “?” subcommand to display the last subcommand entered. 


2 eee 


Usage Notes: 


1. The subcommand that is displayed as a result of a question mark (?) can be 
reexecuted by pressing the ENTER key. You can also modify the command 
before entering it again. 


2. Successive execution of the “?” subcommand will display the previous subcom- 
mands. 


3. A synonym cannot be defined for the ? subcommand. 
4. The “?” subcommand can be assigned to a PF or a PA key. 


( ” 5. Anything following a ? is ignored except another ?. Multiple question marks can 
| be specified to retrieve previous subcommands. 


6. The results of the execution of the equal (=) subcommand may not be 
identifical to the results of combining the “?” subcommand and the ENTER key. 
The “=” subcommand executes the last valid dump viewing facility subcom- 
mand. 


Response: 


( : The system displays the last command line entered from the terminal. 
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= Subcommand 
Use the “=” subcommand to reexecute the last DUMPSCAN subcommand entered. 
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BACKWARD Subcommand 
( - The BACKWARD subcommand scrolls backward toward the lowest address in the 
, dump. 


The format of the BACKWARD subcommand is as follows: 


[ecard [OO 


Usage Notes: 


1. The BACKWARD subcommand can be used after you issue the DISPLAY, 
LOCATE, FINDMOD, TRACE, or other scrolling subcommands. 


2. The BACKWARD subcommand may be reissued by pressing the ENTER key 
(“null line” subcommand). 


3. ScrollUp and Scroll Up are functionally equivalent synonyms for the BACK- 
an WARD subcommand. These are VM/SP Interactive Problem Control System 
( (PCS) subcommands. 


4. For scrolling forward to the highest address in the dump, see the FORWARD 
subcommand later 1n this chapter. 


5. If you entered the OFFSET operand on the previous DISPLAY subcommand, 
then the BACKWARD subcommand continues to display data using the speci- 
fied offsets. Your terminal screen continues to display the original storage 
address requested. 


( 6. The BACKWARD subcommand does not wrap the screen. 
7. You cannot display data with offsets below 0. 
Responses: 
One full screen of data is presented in both hexadecimal and EBCDIC. For 


example, if your screen displays 19 lines, the data at the top of the screen (first line) 
is hex 130 bytes from the last address displayed. 


_ When scrolling after the TRACE subcommand, the format of the next screen is iden- 
( : tical to the screen when TRACE was entered. For example, if the previous TRACE 
Ee subcommand was for FORMAT output, scrolling continues with formatted output. 
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BLOCK Subcommand | 
Use the BLOCK subcommand to format control blocks within a dump. You can 
format the entire block or only selected fields. You can also request that a prede- 
fined subset of high interest fields be formatted. 


The format of the BLOCK subcommand follows: 


oe: ALL 


{ name } address [ BITS | [ OFFSET ] | PROMPT | 


Where: 


name 
is the 1- to 8-character name of the control block to be formatted. 


is an indication to the dump viewing facility that you want it to identify the 
block using the control block ID (CBID). 


Note: See the second usage note for information on address and name verifica- 
tion. 


address 
is a 1- to 8-digit hexadecimal address indicating the storage location of the 
control block. 


BITS —_ 
is a keyword indicating that the bits within a byte should be formatted when aed 
possible. | 


Note: If not specified, then only information down to the byte level is for- 
matted. | 


OFFSET 
is a keyword indicating that the display should be formatted using relative 
offsets from the start of the control block instead of actual addresses. 


ALL | 
is a keyword indicating that all fields within the control block are to be for- ae 
matted. 


PROMPT | 
is a keyword indicating that the user would like to be prompted for the field 
names to be displayed. 


Usage Notes: 


1. If you do not specify either ALL or PROMPT, only fields that are marked as 
“default” in the table for the control block are displayed. 


2. BLOCK does not verify that the control block name provided is valid for the 
address given. If the user gives BLOCK the wrong address, BLOCK simply 
maps the storage into the control block definition as if the address were correct. 


3. When using the PROMPT function of BLOCK, you can display a selected 
group of fields and then discover that additional fields need to be displayed. In 
this instance you need not retype all of the fields entered previously. When 
prompted for the fields to be displayed, you have the option of reusing the old 
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===> 


ADDR/OFF 


00020000 
00020001 
00020002 
00020004 
00020008 
0002000C 
00020010 
00020014 


9002001C 


fields and having the new fields added to the display. This is accomplished by 
entering an equal sign (=) followed by the name of the new fields. BLOCK 
redisplays the previous fields followed by the new ones. The following is an 
example of the use of PROMPT with an equal sign. 


On a prompt for field names to be displayed, you have entered the following: 
fieldl field2 field3 field4 


You now want to add fields 5 and 6 to the display. After reentering the BLOCK 
command with the PROMPT keyword, you are again prompted for the field 
names to be displayed, and enter the following: 


= field5 field6 


BLOCK displays the fields in the order that you entered them. The program 
does not try to order the fields nor does it check for duplicate fields. BLOCK 
only verifies that a name entered by the user actually exists in the control block 
definition. 


. You can flag any field as a default field with the exception of BIT subrecord 


fields. If a BIT field is flagged as a default field and the BITS keyword was spec- 
ified, the bits are displayed. If just the BIT subrecord field is flagged, the flag is 
ignored. 


Examples: 


The following examples demonstrate how the various BLOCK operand and keyword 
combinations provide you with the control block data you need. 


The user enters the following: 


block userblok 20000 all 


NAME 


USERFLGA 
USERFLGB 
* 

USERLINK 
USERCBID 
USERREGF 
USERREGE 
USERTIME 


USERFLGC 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 
BLOCK USERBLOK AT LOCATION 00020000 


CONTENTS DESCRIPTION 

A2 EVENT STATUS FLAGS 

3E EVENT STATUS FLAGS #2 

0000 RESERVED 

00389008 LINK POINTER 

‘USBK! CONTROL BLOCK IDENTIFIER 

00023810 SAVED RETURN CODE FROM CALL 

00650101 SAVED REGE FROM PRIOR CALL 

6DFC83E94AA3CB13 TIME OF DISPATCH TO CPU 1 
DISPATCHER/SCHEDULER ROUTINE 

Al LOCK FLAGS 


Figure 29. BLOCK with the ALL Keyword 
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The user enters the following: 


block userblok 20000 bits offset 


==>Dumpscan Release 2.0 <=== 


Figure 30. BLOCK with the BITS and OFFSET keywords 


ADDR/OFF 


00000000 


990000001 
eoo00002 
0000004 
90000008 
9900000C 


00000010 


80000014 


0000001C 


Block Tables 


NAME 


USERFLGA 
USERBIT1 


- USERBIT2 
USERBIT3 ..1. 


> DumpName CPDUMPO1 <===> DumpType CP <=== 
BLOCK USERBLOK AT LOCATION 00020000 


USERBIT4 . 


USERFLGB 


* 


USERLINK 
USERCBID 
USERREGF 
USERREGE 
USERT IME 


USERFLG@C 
USERLOC2 


A 


CONTENTS 


ga) 
3E 
0000 
00389008 
‘USBK' 
00023810 


00650101 


6DFC83E94AA3CB13 


Al 


0 .00. 


DESCRIPTION 


EVENT STATUS FLAGS 

1/0 IN PROGRESS 
DEACTIVATE STARTED 
SESSION ENDED 

PURGE Q REQUESTED 

EVENT STATUS FLAGS #2 
RESERVED 

LINK POINTER 

CONTROL BLOCK IDENTIFIER 
SAVED RETURN CODE 

FROM CALL 

SAVED REGE FROM 

PRIOR CALL 

TIME OF DISPATCH TO 

CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE 

LOCK FLAGS 

DISPATCH STATUS FLAGS FOR 
THE PRIMARY CPU DISPATCHER 


Block Definitions: The BLOCK subcommand displays a control block by mapping 


the contents of storage into a predefined format. This is accomplished by using a 


previously defined description of the control block. The control block descriptions 


are formatted as follows: 


e Fach field within a control block is described to the BLOCK subcommand in a 
single record called a block definition record. 


e The entire control block description is made up of groups of these definition 


records and is called a block definition. 


e The block definitions are stored in large files and are called block table files. 


Here are examples of the above. 


76 Dump Viewing Facility Operation Guide and Reference 


CONTROL BLOCK 
IDENTIFIER 


8 (8) CHARACTER 


4 USERCBID 


Figure 31. A Block Definition Record: A Single Field within a Control Block 


Note: See “Block Descriptor Record Format” on page 79 for record layout. 


*** USER BLOCK NONDISPLAYABLE COMMENT 
000 0 (Q) STRUCTURE 29 USERBLOK 


010 0 (QO) BIT 1 USERFLGA EVENT STATUS FLAGS 


011 
012 
012 
012 
012 
012 
012 
013 
010 
020 
040 
030 
QAO 
060 
QAO 
080 
QAO 
090 
QAO 
OA0 
010 
O11 
QAl 
OAl 


eUita: eee 
(1) BIT 

(2) FIXED(U) 
(4) POINTER 
(8) CHARACTER 


(C) OFFSET 


(10) FIXED(S) 


(14) AREA 


(1C) BIT 
Leet vedi 


USERBIT1 
USERBIT2 
USERBIT3 
USERBIT4 
USERBIT5 
USERBIT6 
USERBIT7 
USERBIT8 
USERFLGB 
* 

USERLINK 
USERCBID 


USERREGF 


USERREGE 


USERTIME 


USERFLGC 
USERLOC2 


I/O IN PROGRESS 
DEACTIVATE STARTED 
SESSION ENDED 

PURGE Q REQUESTED 
PURGE Q COMPLETED 
DEACTIVATE COMPLETE 
I/O COMPLETE 

PURGE Q 1/0 WAIT 
EVENT STATUS FLAGS #2 
RESERVED 

LINK POINTER 
CONTROL BLOCK 
IDENTIFIER 

SAVED RETURN CODE 
FROM CALL 

SAVED REGE FROM 
PRIOR CALL 

TIME OF DISPATCH TO 
CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE 
LOCK FLAGS 

DISPATCH STATUS FLAGS 
FOR THE PRIMARY CPU 
DISPATCHER 


Figure 32. A Block Definition: The Group of Records Defining a Single Block 
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| *** FIRST BLOCK DEFINITION 


000 
010 
011 
012 
012 
013 
010 
020 
040 
030 
OAO 
060 
QAO 
080 
QAO 
090 
OA0 
OAO 
010 
011 
0Al 
OAl 


0 
0 


28 


(0) STRUCTURE 
(0) BIT 
Loa, Ae 


BIT 

FIXED(U) 

POINTER 

CHARACTER 

OFFSET 
(10) FIXED(S) 
(14) AREA 


(1C) BIT 
Teed. odds 


*** SECOND BLOCK DEFINITION 


000 
030 
040 
040 
040 
OAO 
090 
010 
010 


1 


24 
32 


— (@) STRUCTURE 
(0) CHARACTER 
(4) POINTER 
(8) POINTER 
(C) POINTER 


(18) AREA 
(20) BIT 
(21) BIT 


USERBLOK 
USERFLGA 
USERBIT1 
USERBIT2 
USERBIT3 
USERBIT4 
USERFLGB 
* 


USERLINK 
USERCBID 


USERREGF 


USERREGE 


USERTIME 


USERFLGC 
USERLOC2 


BLOKBLOK 
BLOKCBID 
BLOKLINK 
BLOKSTAT 
BLOKWAIT 


BLOKTIME 
BLOKWFLG 


* 


EVENT STATUS FLAGS 
T/O IN PROGRESS 
DEACTIVATE STARTED 
SESSION ENDED 

PURGE Q REQUESTED 
EVENT STATUS FLAGS #2 
RESERVED 

LINK POINTER 

CONTROL BLOCK 
IDENTIFIER 

SAVED RETURN CODE 
FROM CALL 

SAVED REGE FROM 

PRIOR CALL 

TIME OF DISPATCH TO 
THE CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE 
LOCK FLAGS 

DISPATCH STATUS FLAGS 
FOR THE PRIMARY CPU 
DISPATCHER 


THE BLOCKS’ ID FIELD 
LINK POINTER 
ACTIVATE STATUS 

WAIT EVENT BLOCK 
POINTER 

TIME OF DISPATCH 
WAIT FLAGS 

RESERVED 


Figure 33. A Block Table File Containing Multiple Block Definitions 
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a 
| 4 


Block Descriptor Record Format: You can build a block definition record by using 
the following format: 


8 (8) CHARACTER 4 USERCBID CONTROL BLOCK 


IDENTIFIER 


Figure 34. The Block Descriptor Record 


Where: 


Table 1 (Page 1 of 2). Block Descriptor Record Format 
Field Name Field Description 


01-03 Key field A 3-digit value that provides information 
ere about the field to BLOCK. The digits are 
( used as follows: 


Column 1 Default character field. 
Column 2-3 Data type indicator. 

The possible combinations are: 

00 STRUCTURE - Start of definition. 
10 ~=BIT - BIT data. 


( | | | 11 ~=BIT - Bit subrecord start (on byte 
: boundary). 


12 BIT - Bit subrecord. 
13._—~OBIT - Bit subrecord end. 
20 FIXED(V) - Fixed unsigned data. 
30 CHARACTER - Character data. 
7 40 POINTER - Pointer data. 
( | 50 = Reserved for future IBM use. 
: 60 OFFSET - Offset data. 
70 + Reserved for future IBM use. 
80 FIXED(S) - Fixed signed data. 
90 AREA - Area data. 
AO Independent record comment. 


Al Independent subrecord comment. 


** Nondisplayable comment 


The fields’ offset within the block. This field 
is right-justified. 


07-11 Decimal offset 


13-18 Hexadecimal offset The fields’ offset within the block. This field 
is right-justified and bracketed by paren- 
theses. 
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011 Biss 


Table 1 (Page 2 of 2). Block Descriptor Record Format 


| Columns | Field Name | Field Description | 


20-28 The type of data contained in the field. 


30-34 Field/block size The decimal size of the field in bytes This 
field is right-justified. 


37-50 Field/block name The name of the field. The name field can 

| also contain an array element count value. 
This count must be bracketed by parentheses; 
for example, TESTDATA(1024). This indi- 
cates that TESTDATA is an array of 1024 
elements. 


The comments describing the field 


Note: Columns not specifically assigned to a field must contain blanks. 


52-79 


Block Descriptor Record - BIT Subrecord Format: There is an alternate format for 
bit subrecords format records. See the following example: 


USERBIT1 I/O IN PROGRESS 


Figure 35. Alternate Format for Bit Subrecord 


Where: 


Table 2. Block Descriptor Record — BIT Subrecord Format 


Field Name Field Description 


Key field A 3-digit value that provides information 
about the field to BLOCK. The digits are 
used as follows: 


Columns 


Column 1 Default character field. 
Column 2-3 Data type indicator. 
The possible combinations are: 
10 ~=O+BIT - BIT data. 


11 ~=BIT - Bit subrecord start (on byte 
boundary). 


12 ~=OBIT - Bit subrecord. 
13. —=CBIT - Bit subrecord end. 


16-25 Bit map field The bit placement map used to format bit 
display. 


37-50 Field/block name The name of the bits. 
52-79 The comments describing the field. 


Note: Columns not specifically assigned to a field must contain blanks. 
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Default Display Fields: You can get a display of the default display fields by omit- 
ting the ALL and PROMPT options on the BLOCK subcommand. You select the 
fields to be displayed as default fields. This is accomplished by specifying a default 

field indicator in the definition header record of a block definition. 


000 0 (0) STRUCTURE 29 USERBLOK 


Figure 36. Block Header Record with No Default Settings 


Note: If you want to use a nondisplayable comment, you cannot use an asterisk for 
the default character within that block. 


The default character for a block is set by altering the first character of the KEY 
field. For example, we will use the letter D to signify that a field is a default field. 
The user may specify any valid EBCDIC character as the default character. 


DOO 0 (0) STRUCTURE 29 USERBLOK 


Figure 37. Block Header Record Set to Default of D 


Altering a block definition header record KEY field indicates to the BLOCK sub- 
command that any field record within the definition that has the same character in 
the first character position of the its own KEY field is to be considered a default 
field. For example, the following block field would be considered a default field. 


D30 8 (8) CHARACTER 4 USERCBID CONTROL BLOCK 
DAO IDENTIFIER 


Figure 38. Field record - Set to Default of D 


Tailoring a Block Table File: You can customize an existing definition by: 
¢ Changing the control block name in the header record 
e Changing the names of various fields 
¢ Deleting fields of no interest 
e Adding new fields, such as bit subrecords 


e Changing comments for the field. 


Essentially, you can modify anything.in the definition with the following cautions: 


¢ The control block and field size values. The field size value tells BLOCK how 
much data to map into that particular field. The block size value tells BLOCK 
how much data to get from the dump to map into the block. 


e The field offset values. These fields tell block exactly where, within the storage 
of the control block, the data to be mapped is located. 


In this case, the control block name is changed. 
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DOO 0 (@) STRUCTURE 29 USERBLOK 


& 
‘ee 
‘is changed to: 
Ded Q@ (0) STRUCTURE 29 MYBLOCK1 
In this case, the field name and the comment are changed. 
(8) CHARACTER 4 USERCBID CONTROL BLOCK 
| | IDENTIFIER 
is changed to: 
(8) CHARACTER 4 BLOCKID THE BLOCKS ' , 
ID FIELD 
a 7% 
‘ Z 
jo 
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In this case, a bit breakdown is added to a definition: 


Cc 000 0 


(Q) STRUCTURE 


010 0 (0) BIT 
011 \ ae 
012 lee 
012 an 
013 ye ar 
010 ] (1) BIT 
020 2 (2) FIXED(U) 
| 040 4 (4) POINTER 
030 8 (8) CHARACTER 
OA 
060 12 (C) OFFSET 
0A0 
086 16 (10) FIXED(S) 
QAO 
po 090 20 (14) AREA 
( 0A0 
- OAO 
010 28 (iC) BIT 
011 Pee. 4d 
OA] 
OAl 
is changed to: 
( (Q) STRUCTURE 


(0) BIT 


( send 
eee BIT 
FIXED(U) 
POINTER 
CHARACTER 
OFFSET 
(10) FIXED(S) 


(14) AREA 


(1C) BIT 
Poak. gis 


29 
1 


> PP hw eH 


USERBLOK 
USERFLGA 
USERBIT1 
USERBIT2 
USERBIT3 
USERBIT4 
USERFLGB 
* 

USERLINK 
USERCBID 


USERREGF 
USERREGE 


USERTIME 


USERFLGC 
USERLOC2 


USERBLOK 
USERFLGA 
USERBIT1 
USERBIT2 
USERBIT3 
USERBIT4 
USERBIT5 
USERBIT6 
USERBIT7 
USERBIT8 
USERFLGB 
* 

USERLINK 
USERCBID 


USERREGF 
USERREGE 
USERTIME 


USERFLGC 
USERLOC2 


EVENT STATUS FLAGS 
1/0 IN PROGRESS 
DEACTIVATE STARTED 
SESSION ENDED. 

PURGE Q REQUESTED 
EVENT STATUS FLAGS #2 
RESERVED 

LINK POINTER 

CONTROL BLOCK 
IDENTIFIER 

SAVED RETURN CODE 
FROM CALL 

SAVED REGE FROM 

PRIOR CALL 

TIME OF DISPATCH TO 
THE CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE 
LOCK FLAGS 

DISPATCH STATUS FLAGS 
FOR THE PRIMARY CPU 
DISPATCHER 


EVENT STATUS FLAGS 
1/0 IN PROGRESS 
DEACTIVATE STARTED 
SESSION ENDED 

PURGE Q REQUESTED 
PURGE Q COMPLETED 
DEACTIVATE COMPLETE 
1/0 COMPLETE 

PURGE Q 1/0 WAIT 
EVENT STATUS FLAGS #2 
RESERVED 

LINK POINTER 

CONTROL BLOCK 
IDENTIFIER 

SAVED RETURN CODE 
FROM CALL 

SAVED REGE FROM 

PRIOR CALL 

TIME OF DISPATCH TO 
THE CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE. 
LOCK FLAGS 

DISPATCH STATUS FLAGS 
FOR THE PRIMARY CPU 
DISPATCHER 
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(@) STRUCTURE 29 USERBLOK 
(0) BIT USERFLGA EVENT STATUS FLAGS 
USERBIT1 1/0 IN PROGRESS 
USERBIT2 DEACTIVATE STARTED 
USERBIT3 SESSTON ENDED 
USERBIT4 PURGE Q REQUESTED 
USERBIT5 PURGE Q COMPLETED 
USERBIT6 DEACTIVATE COMPLETE 
‘ USERBIT7 1/0 COMPLETE 
ee USERBIT8 PURGE Q 1/0 WAIT 
BIT | USERFLGB EVENT STATUS FLAGS #2 
FIXED(U) - RESERVED 
POINTER USERLINK LINK POINTER 
CHARACTER USERCBID CONTROL BLOCK 
IDENTIFIER 
OFFSET USERREGF SAVED RETURN CODE Ps 
FROM CALL | 
FIXED(S) USERREGE SAVED REGE FROM 
PRIOR CALL 
AREA USERTIME TIME OF DISPATCH TO 
THE CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE 


is changed to: 


Nee” 
(0) STRUCTURE USERBLOK 
(0) BIT USERFLGA EVENT STATUS FLAGS 
USERBIT1 1/0 IN PROGRESS 
eee USERBIT2 DEACTIVATE STARTED 
oe USERBIT3 SESSION ENDED 
sdtsse USERBIT4 PURGE Q REQUESTED 
BIT | USERFLGB EVENT STATUS FLAGS #2 
FIXED(U) * RESERVED 
POINTER USERLINK LINK POINTER —_ 
CHARACTER USERCBID CONTROL BLOCK a, 


IDENTIFIER 

OFFSET USERREGF SAVED RETURN CODE 
FROM CALL 

FIXED(S) USERREGE SAVED REGE FROM 
PRIOR CALL 

AREA USERTIME TIME OF DISPATCH TO 
THE CPU 1 DISPATCHER/ 
SCHEDULER ROUTINE 


Creating Block Files: You can alter the block definitions and create new definitions 
in user block table files. You must observe the following limitations, however: 


e A block table file must have a logical record size of 80. 


e The record format must be fixed. 


¢ The file cannot exceed 32 656 records in length. — 
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* A maximum of 2048 blocks can be defined per block table. 


¢ The filename of the file must be unique. This is necessary to ensure the right 
block definitions are loaded into BLOCK during initialization. If the name is 
not unique, BLOCK loads the first occurrence of the name based on the CMS 
minidisk search order. 


Creating BLOCK Control Files: Once the BLOCK table file is built, you must deter- 
mine in which of the BLOCK control files the new definition filename should reside, 
and what order position the file will occupy. 


A maximum of four block table files can be used in a single block session. 


The block control file is a file that tells BLOCK which block table files to load 
during initialization. The definition files loaded depend on the type of dump the 
user is currently examining. When BLOCK initialization starts, BLOCK uses the 
dump type to search a table called HCSTBL. See Appendix E for more information 
on HCSTBL. When a match is found on the DUMPTYPE, the entry in the 
HCSTBL is checked for a block control file. If that exists, the suffix is appended to 
the characters HCS$ to form the filename of the a control file name (the filetype is 
always TABLE) for that dump type. BLOCK then searches for that control file and 
extracts the names of the block definition files for the dump. Once you know the 
name of the control file for the dump being examined, you simply put the name of 
the new file in the order position desired. The position of the file 1s important. 
BLOCK searches for control block names sequentially. This means that the first 
definition file is searched first, the second searched second, and so on. Once BLOCK 
finds a match to the name entered on BLOCK invocation, the file search stops and 
BLOCK maps the data based on that definition. BLOCK does not recognize dupli- 
cate names within a definition file. 


Once you have added the new definition filenames, the file should be saved on a 
minidisk that is ahead of the original control file disk in the CMS search order. 


The following is an example of a simple BLOCK control file. The file has records 
80 bytes long. In this example, MYFILE CBMAP is added to a BLOCK control 
file. 


KKKKKKKKKKEKEKEKEREREREREREREKEREREREREREREREEEREERERERERREREREEERE 


* The base CP control blocks for VM/SP . 


BREKKEKKKEKERERERERERERERERERREKEERERERRREERREREREREREREREREREERREEERE 


CPBLOCK1 CBMAP 
CPBLOCK2 CBMAP 


is changed to: 


KKK KKK KKK KEK RRR RRR EKER ERR RRR ERE REE RRERERRERRERRRRRERE 


* The base CP control blocks for VM/SP ” 


KEKKKEKKEKKEKRKEKRKERERERRERERERKERREKEKEREREREREREREEREERERERRRERERER 


MYFILE CBMAP 
CPBLOCK1 CBMAP 
CPBLOCK2 CBMAP 
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CHAIN Subcommand : | 
| Use the CHAIN subcommand to do any of the following: 


e Display the addresses for the control blocks on a chain 

¢ Display the data in the control blocks on a chain — 

e Display a count of the number of control blocks on a chain 
¢ Detect any loops in a chain of control blocks. 


This subcommand accepts a 24- or 31-bit qualifier for the address. 


The format of the CHAIN subcommand is as follows: 


0 
address linkdisp | q | endval | LIST a | 


COUNT | 500 
increment 


length 


Where: 


address 
is a 1- to 8-digit hexadecimal address specifying the starting address of the first 
control block on the chain. 


linkdisp 
is a 1- to 6-digit hexadecimal operand specifying the displacement into the 
current control block where a pointer to the next control block in the chain is 
located. The default is ? (question mark), which is 31-bit addressing. If you 
wish to override the default addressing, enter the % operand for 24-bit 
addressing. The valid range of the linkdisp operand is from hex 0 to FFFFFF. 


endval 
is a 1- to 8-digit hexadecimal operand specifying the value of the pointer in the 
last block of the chain. 


LIST 
indicates that only a list of control block addresses and a decimal count of the 
control blocks be displayed. The control blocks themselves are not to be dis- 
played. LIST is the default for the command. 


offset 
is a 1- to 6-digit hexadecimal offset indicating the starting address from which 4 
contiguous bytes of data are to be displayed. The valid range of the offset 
operand is from hex 0 to FFFFFF. The default is 0. 


COUNT 
is a keyword specifying that only a count of the total number of control blocks 
on the chain and not the addresses or control blocks themselves be displayed. 
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OC) 


increment 
is a 1- to 4-digit decimal number designating how often the following message is 
issued: “nnnn ENTRIES - PROCESSING CONTINUES.” The default 1s 500 
entries. 


length 
is a 1- to 4-digit hexadecimal operand indicating the number of bytes to be dis- 
played. The valid range of the length operand is from hex 0 to 1000. However, 
the control block itself may be larger. 

Usage Notes: 


1. The default indirect addressing mode is ? (question mark), which is 31-bit 
addressing mode. You can override the default addressing by specifying a 
percent sign (%) for 24-bit addressing mode. 


2. If the number of control blocks on the chain exceeds 4096, a message is issued. 
Entering a null line continues the chain presentation starting with the last 
address displayed. 


3. If you restart chain processing with the null line, the last address displayed 
becomes the first on the new chain. 


4. If the address of the next control block in the chain has already been found in 
the current group of 4096 blocks, an error message is issued and processing ends. 


5. If a loop of greater than 4096 entries exists it is not detected. 
Responses: 


The hexadecimal address of each block found in the chain and a decimal count of 
the number of blocks found is displayed. 


Example: 


Figure 39 shows an example of a chain of control blocks. 


BLOCK 1 BLOCK 2 BLOCK 3 
00123400 > 010A80B0 > 00002460 ee 
04 B4 64 
08 B8 68 
oc BC 6C 
10 jo10A80B0) Co| 00002460 70 | 04020080) 
eel a aaa 


Figure 39. Example of a Chain of Control Blocks 


Assume you know the following about the chain of control blocks: 
1. All the blocks in the chain have the same format. 
2. The address of the first block is 00123400. 
3. The pointer to the next block in the chain is at offset hex 10 into the block. 
4. The last block in the chain contains a pointer value of zero. 


If you wanted to view the addresses of the control blocks, you would enter this 
subcommand: | 


chain 123400 10 0 
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==>Dumpscan 
CB. #(0001) 
0000 
0010 
0020 
0030 
0040 


| CB #(0002) 
0000 
0010 
0020 
0030 
0040 


The output displayed appears in a list format: 


CHAIN 123400 10 0 

CB # 0001 AT 00123400 
CB # 0002 AT 010A80B0 
CB # 0003 AT 90002460 
CB # 0004 AT 04020080 


0004 ENTRIES WERE FOUND IN THE CHAIN 


If you wanted to view the addresses of a chain of control blocks, but with 24-bit 
addressing specified, you would enter this command: 


chain 203010 4% 0 


The output displayed appears in a list format: 


CHAIN 203010 4% 0 

CB # 0001 AT 00203010 
CB # 0002 AT 00203330 
CB # 9003 AT 00203120 
CB # 0004 AT 00203110 
CB # 0005 AT 00203100 
CB # 0006 AT 002030FO 
CB # 0007 AT 002030E0 
CB # 0008 AT 002030D0 


The list would continue until all the blocks on the chain are listed. As with the 
example for 31-bit addressing, the total number of blocks on the chain are listed for 
24-bit addressing requests. Figure 40 shows an exainple of the output from the 
CHAIN subcommand when the length operand Is specified. 


The subcommand entered 1s: 
chain 900818 0 0 50 


Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 
ADDR(00900818?) LINKDISP(00000000) ENDV (00000000) REN CEHOeeO ew) 


01F2C008 
00000000 
00000000 
00000000 
00000000 


00000008 
00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 
C5D9C5D7 
00000000 


QO000000 06 *.2.............. 


00000000 
00000000 
40404040 
00000000 


* 


ADDR(01F2C008?) LINKDISP(00000000) ENDV (00000000) LEN(00000050) 


00000000 
01047650 
00000000 
4CE5D4C3 
00000006 


00000000 
00000028 
00000000 
AC4C4cac 
6E6E6E6E 


0002 ENTRIES WERE FOUND IN THE 


==> 


E2ZE8E2E3 
00000000 
00000000 
80000458 
00000000 


CHAIN 


C5D44040 06 * 


00000000 
00000000 
OOE5D4C3 
00000000 


SYSTEM * 


Figure 40. Sample Output of a CHAIN Subcommand with a Length Specified 
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. Figure 41 shows an example of the output from the CHAIN subcommand when 
( LIST and an offset are specified. The subcommand entered is: 


chain 362b000 600 0 list 540 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
CB # 0001 AT 0362B000 DATA => 00010000 
CB # 0002 AT 03622000 DATA 00010000 
0003 AT 03615000 DATA => 00010000 
0004 AT 03602000 DATA => 00010000 
0005 AT 035F9000 DATA => 00010000 
0006 AT 035F0000 DATA => 00010000 
0007 AT 035E7000 DATA => 00020000 
0008 AT 035B8000 DATA => 00010000 
0009 AT O35AF000 DATA => 00010000 
0010 AT 035A6000 DATA => 00010000 
0011 AT 0359C000 DATA => 00010000 
0012 AT 03767000 DATA => 00020000 
0013 AT 0375A000 DATA 00010000 
0014 AT O3E2A000 DATA => 00010000 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


0014 ENTRIES WERE FOUND IN THE CHAIN 


===> 


Figure 41. Sample Output of a CHAIN Subcommand with LIST and an Offset Specified 
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CMS Subcommand 


Use the CMS subcommand to enter the CMS subset environment. 


The format of the CMS subcommand is as follows: 


CMS { commandline | | 


Where: 


commandline 
is any valid CMS command. 


Usage Notes: 


1. If you enter the CMS subcommand without an operand, you enter CMS subset 
mode. 


2. If you try to execute a CMS command that terminates abnormally, changes 
during the dump viewing session can be lost. You should try to save the current 
session file before using the CMS subcommand. 


3. Any CMS command should be prefaced with CMS to prevent the dump viewing 
facility or XEDIT from decoding the subcommand. This should be done to 
prevent cases where a CMS command can be interpreted as a dump viewing 
facility or XEDIT subcommand. 


4. Using CMS commands that run in the user area has unpredictable effects on 
DUMPSCAN, usually resulting in termination. 
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CPU Subcommand 


Use this subcommand to display the CPU address and the prefix register value for 
each processor in the dump. 


The format of the CPU subcommand is as follows: 


Usage Notes: 
1. This subcommand does not clear the screen prior to displaying information. 
2. The failing processor is always listed first. 
3. For more information about any processor in the system, use the REGS, 
CREGS, or GREGS subcommands. 
( _ Sample Output: 


Figure 42 illustrates the output you receive after entering the CPU subcommand. 
The subcommand entered 1s: 


cpu 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
CPU ADDRESS IS 0000 PREFIX REGISTER IS 0095E000 (FAILING) 


( : CPU ADDRESS IS 0001 = PREFIX REGISTER IS 01CB0000 


= ===> 


Figure 42. Sample Output of a CPU Subcommand 
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CREGS Subcommand | 
Use the CREGS subcommand to display the control registers for a specified CPU & 
address. . 


The format of the CREGS subcommand is as follows: 


ound 


Where: 


cpuaddr ; 
is a 1- to 4-digit hexadecimal number specifying the processor address for which 
the information is to be displayed. 


Usage Notes: 


1. If the cpuaddr operand is not specified, it defaults to the failing processor for a 
CP abend dump, the IPL processor for a stand-alone dump, or the processor on 
which the CP VMDUMP command was issued for the virtual machine. 


2. Use the CPU subcommand to obtain the processor addresses in the dump. 
Sample Output: 


Figure 43 illustrates the output of the CREGS subcommand for the failing 
processor. The subcommand entered is: 


cregs ee 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
CPU ADDRESS - 0000 
CONTROL REGS 0O - 15 


JOBOFE4O 00800001 00000000 00000000 00000000 DQD000D0 80000000 00000000 
90000000 00000000 00000000 00000000 01FA8681 Q0000000 5FOQ0000 00000000 


<=<=—=> 


Figure 43. Sample Output of a CREGS Subcommand ee: 
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DISPLAY Subcommand = 
Use the DISPLAY subcommand to display areas of the dump. You can specify an 
address, an indirect address, or request data to be displayed by offsets from an 
address. 


The format of the DISPLAY subcommand is as follows: 


Display address E [length] [OFFSET] 
? 
Where: 
address 


% 


is the 31-bit (4-byte) hexadecimal address from which the data is to be displayed. 


specifies a 24-bit indirect address. A word (4 bytes) of storage at the specified 
address is read from the dump. The low-order 24 bits are used to compute the 
address that is displayed. 


specifies a 31-bit indirect address. A word (4 bytes) of storage at the specified 
address is read in from the dump. The low-order 31 bits are used to compute the 
address displayed. 


length 


is an optional operand. It is a 1- to 4-digit nonzero hexadecimal number indi- 
cating the length in bytes to be displayed. The valid range is from hex | to 
FFFF. If this is specified, the screen is not cleared. If it is not specified, the 
screen is cleared and the output is displayed. 


One screen of dump date is presented in both hexadecimal and EBCDIC. 


OFFSET 


is an optional operand. If you specify it, the leftmost column of the output con- 
tains the offsets from the input address instead of the storage address of the 
data. The data is displayed to the nght of the column of offsets. 


Usage Notes: 


1. A period (.) used as a delimiter between the address and the length is acceptable. 


If the indirect addressing qualifier is specified, the delimiter should follow the 
qualifier. 


. A“T” preceding the address operand (for example, Taddress) is used to provide 


compatibility with the CP DISPLAY command. The DISPLAY subcommand 
always provides the EBCDIC translation whether “T” is specified or not. 


. If you specified an indirect address, the resulting address appears in parentheses 


in the output as part of the command line. 


. The minimum output is one 16-byte line with EBCDIC translation. 


. If you specify the length operand, the resulting display is rounded to start and 


end on a hex 10 boundary (see Figure 47). 


. Each line includes 16 bytes of hexadecimal data with the EBCDIC translation. 


In addition, the key of the page is displayed on the first line and subsequent 
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_ page boundaries. It appears between the hexadecimal data and its EBCDIC 
translation. 6. 


7. OFFSET and length are operands that may be specified in any order. <2 


8. If you specify the OFFSET keyword operand, the leftmost column of the output 
contains the hexadecimal offset from the starting address instead of the 31-bit 
storage address. 


9. If only partial data is available in the dump, DISPLAY presents all of the avail- 
able data, then an error message is issued. © — _ 


Sample Output: 


Figure 44 illustrates the results of the command DISPLAY 9F0000. Notice that the 
left-most column contains the storage address of the data. The subcommand entered 
is: , 7 

display 9f0000 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPOQ1 <===> DumpType CP <=== 
DISPLAY 9F0000 


O09FOQ000 OOOAIEQ1 I1FEEIFFF 1F225810 2CiCBBOE 06 
* 


009F0010 
009F0020 
009F0030 
009F0040 
009F0050 
009F0060 
009F0070 
009F0080 
009F0090 
009FO0A0 
009FOOBO 
009FO0CO 
009F00D0 
O0O9FOOEO 
OO9FOOFO 
009F0100 
009F0110 
009F0120 
009F0130 
009F0140 
009F0150 
009F0160 
009F0170 
009F0180 
009F0190 
O009FO1A0 
009F01B0 
Q009FO1CO 


===> 


20185820 
C90C58E0 
ODEFO6FO 
54400B1C 
5820900C 
1F445040 
D9D7C304 
00800000 
00000200 
00000000 
00000118 
OO9FOEES 
O0A6B868 
00A20010 
FFFFFOFF 
07000700 
47FOF060 
F2FOFOFO 
F44BF4F3 
404DC35D 
C2D440C3 
40F1iF9F8 
5FCOCCAO 
D068D703 
DO5CA03C 
4550C9D2 
AQ2C47D0 
CO481FEE 


2A4C5520 
1Q00012FE 
BAEF1000 
55400014 
18321F34 
0C1407F6 
OQAOOD9D7 
00008900 
FFBFFFFF 
3D090000 
FF7FFFBE 
009FCO80 
OO9FOEFO 
009C4818 
OO9DEEOO 
O700FFFF 
C8C3D7D9 
OOOOF1F1 
DOC5F5F6 
40C3D6D7 
D6D9D7D6 
F36BF1F9 
D727D058 
DO64D064 
D203D060 
D202D06C 
C6484130 
43E0D071 


0A484770 
4720C842 
47700836 
4770C876 
BA23900C 
OAQ0D9D7 
C3060000 
00000020 
FFBFFE2F 
00000060 
00800000 
OO9FC1A0 
QO9E6A98 
00000001 
009DE270 
C3C80060 
E2C54040 
61F1F261 
FOF460F3 
E8D9C9C7 
D9OC1E3C9 
F8F80000 
DO0581F77 
D700D07B 
AQ54D703 
DO714130 
08014930 


89E00002 | 


C81A5810 
58F0C8D8 
58408000 
41400001 
4770C864 
C3010A00 
00400000 
00000400 
FFFFFEA8 
0099A7E0 
QO9EB2C8 
O00A6B/D0 
009C4748 
00A01970 
009ED598 
D7C50118 
O1AAE2D7 
F8F77AFO 
FOF84060 
C8E340C9 
D6D54060 
00000000 
D703D068 
DO7BD203 
AQAOAOA0 
000A4930 
A02847D0 
47FECOCO 
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* 


*,Q0-HCPRSE 


scor™ 


*2000..11/12/87:0* 


*4.43RE5664-308 -* 


* (C) COPYRIGHT I* 


*BM CORPORATION -* 


Figure 44. Sample Output of a DISPLAY Subcommand without the Length Operand 


we anette Ne ami Sede tte 8 


Figure 45 illustrates the display generated using 31-bit indirect addressing with a 
length. The subcommand entered 1s: 


display 9f0080? 40 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
DISPLAY 9FQ080 ? 40 (00800000) 
00800000 80000020 80000020 80000020 80000020 06 * 


00800010 80000020 80000020 80000020 80000020 
00800020 80000020 80000020 80000020 80000020 
00800030 80000020 80000020 80000020 80000020 


===> 


Figure 45. Sample Output of a DISPLAY Subcommand with 31-Bit Indirect Addressing 


( oe Figure 46 illustrates the DISPLAY command using the OFFSET operand. Note 
| that the left-hand column is the offset from the address entered. The subcommand 
entered is: 


d 9f0080? offset 


( 
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==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 < 


DISPLAY 9FOQ080 


0000 
0010 
0020 
0030 
0040 
0050 
0060 
0070 
0080 
0090 
- OOAO 
00B0 
00C0 
Q0D0 
Q0E0 
OOFO 
0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 
0180 
0190 
01A0 
01B0 
01C0 


00800000 
00000200 
00000000 
00000118 
OO9FOEES 
O0A6B868 
00A20010 
FFFFFOFF 
07000700 
47FOFQ60 
F2FOFOFO 
FA4BF4F3 
404DC35D 
C2D440C3 
40F1F9F8 
5FCOCCAO 
D068D703 
DO5CAO03C 
4550C9D2 
AQ2C47D0 
C6481 FEE 
47F0C666 
47F0C666 
47F0C166 
41100138 
AQ009000 
5820CD08 
58FOOA0C 
ODEE9S4DF 


99008900 
FFBFFFFF 
30090000 
FF7FFFBE 
O9FCO80 
QO9FOEFO 
909C4818 
QO9DEEOO 
O700F FFF 
C8C3D7D9 
QOOOF1F1 
DOC5F5F6 
40C3D6D7 
D6D9D7D6 
F36BF1F9 
D727D058 
DO64D064 
D203D060 
D202D06C 
(6484130 
43E0D071 
47FOC666 
47FOC666 
47FOC666 
58FO09D0 
5820CD04 
91498001 
ODEF18A9 
80124190 


OFFSET 


60000020 
FFBFFE2F 
00000060 
00800000 
Q09FC1A0 
QO9E6A98 
00000001 
009DE270 
C3C80060 
E2C54040 
61F1F261 
F6F460F3 
E8D9C9C7 
D9C1E3C9 
F8F80000 
DO581F77 
D700D07B 
AQ54D703 
DO714130 
08014930 
89E00002 
47FOCOE8 
A7FOCI7A 
9500D072 
QDEF189A 
91208001 
47100120 
58F0CD10 
00004090 


> DumpType CP <=== 


00000400 06 


FFFFFEA8 
0099A7E0 
QO9EB2C8 
00A6B7D0 
00904748 
00A01970 
Q009ED598 
D7C50118 
Q1AAE2D7 
F8F77AFO 
FOF84060 
C8E340C9 


D6D54060 | 


eoo00000 
D703D068 
DO7BD203 
AOAOAOAO 
00044930 
A02847D0 
47FECOCO 
47FOC142 
47F0C666 
4770C666 
18A1D2FF 
4710C120 
5820CDOC 
58E00D74 
AQ2E47F0 


*.Q0-HCPRSE ..SP* 
*2000..11/12/87:0* 
*4.43RE5664-308 -* 
* (C) COPYRIGHT I* 
*BM CORPORATION 


-OF..OF..0.Y.0A. 
-OF..OF..0A:.0F. 


[re e«.—06UC® 
+ + FF FF HF FF FE FF FH FHF FE HF F 


+ + F FF F HF F 


Figure 46. Sample Output of a DISPLAY Subcommand with the OFFSET Operand 
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Figure 47 illustrates the DISPLAY subcommand specified with a length. Note that 
the data displayed begins and ends on a hex 10-byte boundary. The subcommand 
entered is: 


display 9efff6 c 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
DISPLAY 9EFFF6 C 


OO9EFFFO 5810D038 58001C24 18185410 OBOC8910 04 * 
QO9FOQOO OOOA1EO1 1FEEIFFF 1F225810 2C1CBBOE 06 * 


==> 


Figure 47. Sample Output of a DISPLAY Subcommand with a Length Specified 
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DUMPID Subcommand 


Use the DUMPID subcommand to display the dump identifier you assigned on a 
VMDUMP command. See VM/XA SP: CP Command Reference for more informa- 
tion on the VMDUMP command. , 


The format of the DUMPID subcommand is as follows: 


Usage Note: 


The DUMPID subcommand is not supported for CP dumps. 
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END Subcommand 


Use the END subcommand to end the session. 


The format of the END subcommand is as follows: 


Usage Notes: 
1. The END subcommand is equivalent to the XEDIT PQUIT subcommand. 


2. If you enter the END subcommand and you have changed the session file, you 
must enter the XEDIT FILE subcommand to save the session file. If you do 
not wish to save the session file, enter the DUMPSCAN QUIT or DUMPSCAN 
HX subcommand. 
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FINDMOD Subcommand 


Use this subcommand either to locate a specified module or entry point in the dump 


or to locate the module and the entry point that resides at a specified address. 


The format of the FINDMOD subcommand is as follows: 


FINDMod module name 


entry point name 
address 


Where: 


module name 


is an alphanumeric string of 1-to-8 characters that specifies a module name. 
Place this variable within single quotes. 


entry point name 


is an alphanumeric string of 1-to-8 characters that specifies an entry point name. 
Place this variable within single quotes. 


address 


is a 31-bit (4-byte) hexadecimal address. 


Usage Notes: 


I. 


10. 


The FINDMOD subcommand requires that a module map of the dump be 
appended to the dump. For CP hard abend and stand-alone dumps only, if a 
load map is not currently appended to the dump, one is built dynamically and 
appended. However, to utilize the dynamic map building capabilities, the dump 
file must be on a CMS disk to which you have write access. 


. If the module name or entry point name operands are entered, the starting 


address of the module or entry point is displayed on the first line of the screen. 


. If the requested module is not in storage, an error message is issued. 


. A string in quotes is processed as a module or entry point name. A string not in 


quotes 1s handled first as an address. If the string is not a valid hexadecimal 
number, it is then processed as a module or entry point name. If the string is 
not a module and is not a valid hexadecimal address, an error message is issued 
indicating the string is not a valid hexadecimal address. 


. The output displays the name and hexadecimal location of the next lowest entry 


point and the displacement of the address from that entry point address, as well 
as the name of the module containing that entry point and the displacement 
from its start. 


. Scrolling subcommands (BACKWARD, FORWARD, + or increment, - or dec- 


rement) can be used once the module is found. 


. If the specified address is not in the dump, an error message is displayed. 


. If the operand entered is either a module name or an entry point name and it 


exits in the dump, the screen is cleared before the information is displayed. 


. If the operand entered is an address, the screen is not cleared prior to display of 


the information. 


MAPA and MAPN are functionally equivalent to the FINDMOD subcommand. 


These are VM/SP Interactive Problem Control System (IPCS) subcommands. 
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THE MODULE 


00996560 
00996570 
00996580 
00996590 
009965A0 
009965B0 
009965C0 
009965D0 
009965E0 
009965F0 
00996600 
00996610 
00996620 
00996630 
00996640 
00996650 
00996660 
00996670 
00996680 
00996690 
009966A0 
009966B0 
009966C0 
009966D0 
009966E0 
009966F0 
00996700 
00996710 
00996720 


===> 


47FOFO60 
F2FOFOFO 
FO4BF2F9 
404DC35D 
C2D440C3 
40F1F9F8 
9O0FF178 
QB101EDC 
D6C8B205 
0A584770 
094001C0 
60609148 
9640D380 
4F10D388 
926BD5F7 
D6000B80 
58FOD6CC 
D6D058E0 
B28050E0 
DOA04780 
50FOE054 
95048000 
91208001 
4780C1B2 
4780C1AA 
C1964100 
50FOEQ54 
C1784110 
00000000 


C8C3D7C4 
OOOOFIF1 
DOC5F5F6 
40C3D6D7 
D6D9D7D6 
F36BF1F9 
18CF4BC0 
4190C1C0 
D398B209 
C09A4190 
60009130 
B211D3B0 
D2039000 
F342D5F3 
F321D603 
4100D398 
ODEF4110 
100055E0 
D3B858E0 
C16858F0 
4770C168 
47800286 
4710CA08 
41770008 
58F0D6D4 
000112FF 
12004780 
D5784590 
00000000 


Sample Output: 


‘hcpdmp ' 


D4D74040 
61F1F261 
F6F460F3 
E8D9C9C7 
DOC1E3C9 
F8F80000 
FO0C4700 
D7039054 
D3AQB207 
DOBO5090 
60209138 
91400B79 
OB801F11 
OB84DC03 
D38E96F0 
1F114120 
D5884590 
B2804740 
B1i3C50E0 
D6D40DEF 
95088000 
95208000 
5870B198 
58807020 
ODEF4100 
4780C1A4 
CA084170 
CEFC47F0 
00000000 


F8F77AFO 
FOF84060 
C8E340C9 
D6D54060 
00000000 
006058D0 
905458B0 
D3A8BF9F 
DOACD23F 
60409140 
47E0COC4 
43100B83 
D5F3D478 
D605D202 
D5C91F33 
CEFC5810 
C12258E0 
D3BCBF8F 
41E0C1C0 
47800240 
4770C168 
BF1F7000 
5980D0A0 
00004780 
41E0C1C0 
70904610 
CD160000 
00000000 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPOQ1 <===> DumpType CP <=== 
OR ENTRY POINT HCPDMP IS LOCATED AT ADDRESS 00996560 
O300E2D7 06 *.00-HCPDMP 


SPX 
*2000..11/12/87:0* 
*Q. 29RE5664-308 -* 
* (C) COPYRIGHT I* 
*BM CORPORATION - 


* 
* 
* 
* 
* 
* 
* 


+ + + % F F HF HF 


Figure 48. FINDMOD Output When a Module Name Is Specified 
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Figure 48 illustrates the data displayed when the FINDMOD subcommand is used 
to locate module HCPDMP. The subcommand entered is: 


findmod 


101 


Figure 49 illustrates the data displayed when an address operand (996770) is speci- 


fied to determine the module that has the address. The subcommand entered is: 


findmod 996770 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType cp <=== 
00996770 IS 210 BYTES INTO MODULE HCPDMP AT 00996560 


00996770 IS 1BO BYTES INTO ENTRY HCPDMPDK AT 009965CO 


===> 


Figure 49. FINDMOD Output When an Address Is Specified 
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-_ 


FINDUSER Subcommand 
_ Use the FINDUSER subcommand (macro) to determine the CP module flow for a 
( hung virtual machine (if the save areas can be successfully located and chained). 
You can also use it to provide key status settings from the virtual machine’s 
VMDBK and display each active save area. FINDUSER helps you find active save 
areas and VMDBK status settings for a specified userid. The output can also be put 
in a separate CMS file. 


ser werid (FH 


Where: 


userid 
is the 1- to 8-character userid you want to locate. 


FILE 
_ is an optional parameter to specify that output will be placed in a separate CMS 
( | file called userid dumpname in addition to the output being appended to the 
\ session file. 


Usage Notes: 


1. This macro is fully supported for a CP hard abend or stand-alone type dump 
only. Partial output (VMDBK status and SAVBK) is displayed for soft abend 
dumps. 7 


2. If only partial data is available in the dump (as in soft abend or virtual machine 
( dumps), FINDUSER may return limited output. 


3. If the FILE option is not specified on input, FINDUSER output will be 
appended to the session file. 


4. The following error messages may be issued by FINDUSER. The action you 
should take appears below each message. 


a. COMMAND FORMAT IS: FINDUSER userid < FILE > 
Reissue the macro with the correct syntax. 
( e b. THE VMDBK FOR userid DOES NOT EXIST IN THE DUMP 


Reissue the macro with a valid userid. The DUMPSCAN subcommand 
VMDBK LIST provides all valid userids. 


c. UNABLE TO FIND START OF SAVE AREAS 
The macro cannot locate the save area queue (HCPRCCCM). 
d. NO ACTIVE SAVE AREAS FOUND FOR USERID - userid 


The macro cannot find any valid save area information for the specified 
userid. The output will contain VMDBK status settings. 


e. UNEXPECTED RC rc AFTER ISSUING: FINDSTRG fsstring fsstart 
fsstop fsincr 


FINDUSER initiated a FINDSTRG subcommand that was not suc- 
cessful. Based on the return code, try to determine if the macro was at 
fault (RC 16) or the subcommand failed. 
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f. UNEXPECTED RC rc AFTER ISSUING: READSTRG rsadr rslen 


FINDUSER initiated a READSTRG subcommand that was not suc- 
cessful. Based on the return code, try to determine if the macro was at ‘ee 
fault (RC 16) or the subcommand failed. 


5. The following messages can appear in the output produced by FINDUSER: 
a. NO ACTIVE SAVE AREAS FOUND FOR USERID - userid 


Valid save area information for the specified userid cannot be found. 
The output will contain VMDBK status settings. 


b. INTERSECTING/CONTAMINATED SAVE AREA CHAINING. SAVE 
AREAS BELOW ARE IN NO SPECIFIC ORDER. 


The active save areas do not chain correctly. Each save area as well as 
the VMDBK status settings will appear in output. 


c. BEGINNING OF SAVE AREA CAN NOT BE DETERMINED. SAVE 
AREAS BELOW ARE IN NO SPECIFIC ORDER. 


The active save areas appear to loop. The output will display each save 
area as well as the VMDBK status settings. ; 


d. MULTIPLE SAVE AREA CHAINS FOUND FOR USERID - userid 


The active save areas form multiple chains. The output will contain 
module flow for each chain and for VMDBK status settings and will 
display each save area. 


Sample Output: 


Once in the DUMPSCAN environment, the FINDUSER macro can be invoked by ee 
typing FINDUSER userid (FILE) on the command line. An example of the 

DUMPSCAN macro FINDUSER follows. The following represents contiguous 

output. The subcommand entered is: 


finduser iucv3 file 


FINDUSER IUCV3 FILE (DUMPNAME CPDUMPO1) | aa 


VMDBK AT 02B9D000 FOR USERID - IUCV3 | es, 


KEKERERERRERERRRERREERERRERREREERRERERRERRERERERERE 


* START OF MODULE CHAIN FOR USERID - IUCV3 a 


KERERERERREERERREREERRERERRRRERRERERERRERERRRRREERE 


O22B6F2A IS 2DA BYTES INTO MODULE HCPVIX AT 022B6C50 


O22B6F2A IS 27A BYTES INTO ENTRY HCPVIXVI AT O22B6CBO 
Q02259E86 IS 6C6 BYTES INTO MODULE HCPIUF AT 022597C0 
Q2259E86 IS 26 BYTES INTO ENTRY HCPIUFRF AT 02259E60 
0225D232 IS 1D2 BYTES INTO MODULE HCPLCK AT 0225D060 
0225D232 IS 11A BYTES INTO ENTRY HCPLCKAX AT 0225D118 


HK fe 24s 24k fe fe Ie ee fe fe Ik Ie fe Ie I ke ie oie fe ie is I ik 2 ie fe I fe fe fe fe 2k ko oie oie 2k 2 ek Ok ok OK ok 


* END OF MODULE CHAIN FOR USERID - IUCV3 


HE 8 2K OK 2s I fe fe fe ie fe 2k ie 2k 2s 2 2 2k Oe OK 2 2 2 ik He ek 2g Ik oie 2 OK 2K 2 2 oe oe OK OK Oe 2 Ke 2 2 OK OK 


Figure 50. FINDUSER Output (1) 
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( . KK IK IKK IKKE KK KKK KKK KEI K KKK KEIRA RIKKI KER ERE ERIK ERIKA 


* START OF SELECTED VMDBK FIELDS FOR USERID - IUCV3 " 


KEEEKRKEREREKRREREKREKRKREKREEREKRERRERREREREKRERERERREREREREKRRERERRERREE 


BLOCK ‘HCPVMDBK' AT LOCATION O02B9D000 


ADDR/OFF NAME CONTENTS DESCRIPTION 
0156 VMDINST(O) B2FO INTERCEPTED INSTRUCTION BIT 0 
0330 VMDWVDEV 00000000 ADDRESS OF VDEVBK FOR STATUS 
0380 VMDCOMND ‘MESSAGE ' LAST CP COMMAND EXECUTED 
0388 VMDCFCTL 01 CONSOLE FUNCTION CONTROL 
VMDCFACT Seas. week "X'O1'" INDICATES THAT THE VI 
0389 VMDCFLAG 00 CONSOLE FUNCTION STATUS FLAGS 
038A VMDOSTAT 44 VIRTUAL MACHINE OPERATING STA 
VMDUSRCT Slat "X'40'" USER INCLUDED IN SYST 
CT 
ce VMDDISC Sen. hes "X'O4'" USER IS RUNNING DISCO 
( 038B VMDCWAIT 00 CF WAIT CONTROL 
038C VMDCFPND rE CONSOLE FUNCTION IS PENDING. 
038D VMDCFPDR Pr CONSOLE FUNCTION READ PENDING 
Q38E VMDCFHXF 00 CONSOLE FUNCTION HALT FLAG. 
Q38F VMDCFLG2 00 CONSOLE FUNCTION STATUS FLAGS 
0390 VMDCFBUF 00000000 THIS IS THE ANCHOR TO A STACK 
0394 VMDCFCAL 00000000 QUEUE OF CPEBKS TO BE 
0398 VMDCFREQ 00 CONSOLE FUNCTION ENTRY FLAG. 
0399 VMDCFDSP 00 CONSOLE FUNCTION ENDOP FLAG. 
Pace Q39C VMDCFCNT 00000001 CONSOLE FUNCTION ENDOP COUNT. 
( Q3AQ VMDCFLKQ 00000000 QUEUE OF CPEBKS THAT DEFERRED 
- Q509 VMDRSTAT 20 RUNNING BLOCKAGE STATUS. THIS 
VMDS IMWT ar "X'20'" PERFORMING GUEST SIMU 
0510 VMDQURCP 00000000 URGENT CPEBK PUSH-THRU STACK 
0514 VMDQIORF 00000000 IORBK/TRQBK PUSH-THRU STACK 
Q518 VMDQCPEF 00000000 CPEBK PUSH-THRU STACK 
051C VMDDFRWK 00000001 DEFERED WORK COUNTER 
0521 VMDWRKCK 00 EXECUTION-BLOCK STACK STATUS 
3 26 246 26 fs 2k 28 2k 26 2k 2s oie 2k fe 2k 2k ik 26 2k 2k ok oie 2s 2k 2k ek 2 Oe 24s 2k 2 Ie 2k 2 ie fe 6 Kk 2K oie 2 2k I 3k oe oe 2k 2 2 2k ie 2 2 oie 2 ok 
( - * END OF SELECTED VMDBK FIELDS FOR USERID - IUCV3 - 
2S 2K 34 9 3k 246 34 3k 3k 2fe 2k 2Is ie fe aft fe 2fe oie 2g 3k 2k oie 2k 2k fe 2fs 2k 3k ie ik 2 oie 2fe fe ik ie fe fe 24k 2k ik 2k fe ie 24 2fe 2k ie 2 2c 2 2 2s 2k 2 2k 2k 2k ok 


Figure 51. FINDUSER Output (2) 


Note: In the preceding figure, output produced by the BLOCK subcommand was 
modified by the EXEC. Specifically, only bits that were set on were displayed for 
the fields VMDOSTAT, VMDRSTAT, and VMDCFCTL. 
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HII KARI IAA IIIA III IAI IRIE IIIA IAI IAI III III 


* START OF SAVE AREA CHAIN FOR USERID - IUCV3 * 


KREKKREKRERRERRRREREREERERERRERERREERRREERKRERRRRRREKKKE 


DISPLAY 02387D80 


9000 
9010 
9020 
9030 
9040 
0050 
9060 
0070 


DISPLAY Q3EBQBO0 


0000 
0010 
0020 
0030 
0040 
0050 
0060 
0070 


00000000 
00800000 
FF1E4000 
00000000 
Q2B9D000 
822B6F2A 
00000000 
00000000 


00000000 
80400000 
02B9D828 
00000000 
Q2B9D000 
82259E86 
00000000 
00000000 


80 


80 


00000000 
0229500A 
Q228F940 
02259E60 
Q02B9D000 
02259E60 
00000000 
00000000 


00000000 


—02294D70 


0228F940 
02259E60 


O2B9D000 


0225D232 
00000000 
00000000 


OFFSET 


09000000 
FF1E4000 
02259660 
02BE1148 
022B6C50 
02890828 


00000000. 


00000000 


OFFSET 


00000000 
FF1E4000 
02259E60 
02BE1148 
022597C0 
00000000 
00000000 
00000000 


0388A080 
0228F940 
010000E2 
90000000 
03EBOD0O 
90000000 
90000000 
99000000 


0388A080 
02B9D828 
010000E2 
00000000 
02387D80 
Q2B9D000 
00000000 


00000000 © 


KKK AIK ERI KIKI IRI EI KI RISA AIK IISA IRIAN IISA IAIG 


*- END OF SAVE AREA CHAIN FOR USERID - IUCV3 


KKEKREKEERKEKEEKREEREKREREKRERRERRERERRAEKRERRERREKKREKE 


Figure 52. FINDUSER Output (3) 
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FORWARD Subcommand | 
( The FORWARD subcommand scrolls forward toward the highest address in the 
mall dump. 


The format of the FORWARD subcommand is as follows: 


Usage Notes: 


1. The FORWARD subcommand can be used after issuing the DISPLAY, 
LOCATE, FINDMOD, TRACE, or other scrolling subcommands. 


2. The FORWARD subcommand may be reissued by pressing the ENTER key 
(“null line” subcommand). 


3. The SCROLL subcommand is functionally equivalent to the FORWARD sub- 
( “ command. SCROLL is a VM/SP Interactive Problem Control System (IPCS) 
| subcommand. 


4. If the OFFSET operand was specified on the previous DISPLAY subcommand, 
then issuing the FORWARD subcommand continues to display offsets. 


5. You cannot display with offsets beyond hex FFFO. 
6. The FORWARD subcommand does not wrap the screen. 
7. Refer to the BACKWARD subcommand to scroll backward toward the lowest 
address in the dump. 
Responses: 


One full screen of the dump data is presented in both hexadecimal and EBCDIC. 


When scrolling after the TRACE subcommand, the format of the next screen is iden- 
tical to the format of the screen when TRACE was entered. For example, if the 
previous TRACE subcommand was for FORMAT output, scrolling continues with 
formatted output. 
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FRAMETBL Subcommand a | _ 
Use the FRAMETBL subcommand to format and display the contents of a frame f : 
table entry for the frame containing the hexadecimal location specified. The frame wT 
table entry address may also be specified. 


The format of the FRAMETBL subcommand is as follows: 


FRAMEtb1 - gtorage address | 
FRMtb1 ENTRY entry address 


Where: 


storage address 
is a 31-bit (4-byte) hexadecimal number specifying the address whose entry in the 
frame table is to be described and formatted. 


ENTRY | | PaaS 
specifies that an actual frame table entry address will be given. | 


entry address 
is a 31-bit (4-byte) hexadecimal number specifying the address of a frame table 
entry. 


Usage Notes: 


1. The FRAMETBL subcommand is not supported for virtual machine dumps or 
soft abend dumps. 


2. The specified storage address is rounded down, if necessary, to the 4K page 
address. The formatted contents of the frame table entry for this page are dis- 
played. 


3. The frame entry address must be on a 16-byte boundary. 
4. FRMtbl is a synonym for the FRAMEtbl subcommand. 


5. If you specify an entry address outside the boundaries of the frame table but 
within the dump, the data specified is formatted only if it begins at an address 
on a 16-byte boundary. 


6. Table 3 on page 109 describes the possible uses for the real storage frame. oe 
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Table 3. Real Storage Frame Use Table 


FRMOFFLN Offline 

FRMVR V=R Guest Storage 
FRMFRVR V=R Free Storage 
FRMFREE Free Storage 

FRMFRSY System Extended Free Storage 


FRMFRVM VMDBK Extended Free Storage 
FRMCP CP Use 

FRMTRACE Trace Table 

FRMPRFX Prefix Page 

FRMUSER User xXxxxxxx 

FRMSUSER System Virtual Storage 
FRMR370 Real I/O 370 Mode. 


( | | Responses: 


The format of an entry in the frame table depends on the use of the page. Therefore, 
output from the FRAMETBL subcommand varies according to the use of the page 
being displayed. There are three possible responses from this subcommand. These are 
shown below as sample output. In each case, the system does not clear the screen 
before displaying the output from the FRAMETBL subcommand. 


_ In all cases, the static, serialize flags, and dynamic states are defined, and the first 
( | line of output contains: 


e The address of the frame table entry 


e A description of the use of the real storage frame. 
Sample Output: 


Figure 53 through Figure 55 illustrate various output screens generated by the 
FRAMEtbl subcommand. For Figure 53, the subcommand entered is: 


( frm entry 91ff60 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 
FRAME TABLE ENTRY 0091FF60 FRAME USE = SYSTEM VIRTUAL STORAGE 
STATIC FLAGS 80 LOCKED IN REAL STORAGE 


DYNAMIC STATES 00 NO FLAGS SET 
SERIALIZE FLAGS = 01 LAST TRANSLATED COUNT 
LOCK COUNT = 00000001 


===> 


Figure 53. Sample Output of a FRAMETBL Subcommand for a Page Frame Locked in Real Storage 
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For Figure 54, the subcommand entered 1s: 
frm entry 90d5d0 | 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 

FRAME TABLE ENTRY O0090D5D0 FRAME USE = SYSTEM VIRTUAL STORAGE 
PAGE TABLE ENTRY = O1F4E174 | 

FORWARD POINTER = Q090D5E0 BACKWARD POINTER = 0091F2BO0 

STATIC FLAGS 20 ON USER OWNED LIST 

DYNAMIC STATES 0Q NO FLAGS SET 

SERIALIZE FLAGS = 00 NO FLAGS SET 


= 


Figure 54. Sample Output of a FRAMETBL Subcommand for Pages That Are Chained 


For Figure 55, the subcommand entered 1s: 
frm entry 312c20 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
FRAME TABLE ENTRY 00312c20 FRAME USE = FREE STORAGE 
DOUBLE WORDS IN USE = 0930 

NEXT FREE STORAGE FRMTE = 00312B70 TOD STAMP = 0031 


FIRST AVAILABLE FREEBK = 00000000 


STATIC FLAGS 00 NO FLAGS SET a 
DYNAMIC STATES = QQ NO FLAGS SET mS 
SERIALIZE FLAGS = 00 ON AVAILABLE QUEUE | 


=== 


Figure 55. Sample Output of a FRAMETBL Subcommand for a Page Frame Used as System Free Storage 
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GREGS Subcommand 


Use the GREGS subcommand to display general purpose registers for a specified 
processor. | 


The format of the GREGS subcommand is as follows: 


Where: 


cpuaddr 
is a 1- to 4-digit hexadecimal number specifying the physical CPU address for 
which the general registers are to be displayed. 


Usage Notes: 


1. If the cpuaddr operand is not specified, it defaults to the failing processor for a 
CP abend dump, the IPL processor for a stand-alone dump, or the processor on 
which the CP VMDUMP command was issued for the virtual machine. 


2. Use the CPU subcommand to obtain the CPU addresses in the dump. 
Sample Output: 


Figure 56 illustrates the output of the GREGS subcommand for CPU address 0000. 
The subcommand entered is: 


gregs 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
CPU ADDRESS - Q000 
GENERAL REGS @ - 15 


FOFOFOFO FOFOFOF1 01488008 81CF6A44 QOA4B3D8 00000002 O1F3E708 4C4C4C4C 
00000001 OO0A4B3D8 00000002 00800000 O1CF69A0 O1F3C980 81CF6A82 0098A968 


==> 


Figure 56. Sample Output of a GREGS Subcommand 
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HELP Subcommand | 
_ Use the HELP subcommand to display a summary of the DUMPSCAN subcom- A 
mands. The HELP subcommand will describe the specified subcommand, including a : 
syntax, operands, and any relevant usage notes. If you do not enter a subcommand 
name, a list of all DUMPSCAN subcommands will be presented. 


The format of the HELP subcommand is as follows: 


MENU 
subcommand 
Where: 
MENU 
displays a list of all DUMPSCAN subcommands. aa 
subcommand | ho al 


can be any DUMPSCAN subcommand name and causes a description of the 
subcommand to be displayed. If the subcommand is not a DUMPSCAN sub- 
command, a list of all DUMPSCAN subcommands will be presented. 

Usage Notes: 


1. If you do not enter a subcommand name, or if you enter an invalid subcom- 
mand, a list of subcommands is displayed. 


2. DUMPSCAN subcommand abbreviations can be used in the subcommand 
operand. 


Responses: 
The dump viewing facility HELP subcommand provides online information about 
command syntax, formats, and usage notes. The HELP text displayed is the same as 


displayed when HELP is invoked from CMS. 


To display a menu of DUMPSCAN subcommands, enter: | 
help Set 


To display the HELP text of a specific subcommand (for example, for the REGS 
subcommand) enter: 


help regs 
Error Messages 


Error messages are issued from the CMS HELP facility. | 
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we 


Return Codes: 


RC 


11 and above 


Explanation 
Normal. 


Subcommand rejected in the profile due to a LOAD 
error, or a QUIT subcommand has been issued in a 
macro called from the last file in the ring. 


Standard CMS HELP command return codes. 
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"HX Subcommand 


Use the HX subcommand to end the session and return to CMS. The format of the ‘d 
HX subcommand is as follows: | | bs 
Usage Note: 
The HX subcommand is equivalent to the QUIT subcommand. 
Response: 
CMS ready message. 
. 
ee” 
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sieeve, Subcommand 
( Use the LOCATE subcommand to search the dump for a particular string of data. 


The format of the LOCATE subcommand is as follows: 


Locate string fromaddr' toaddr increment 
LocateUp X'string' 

Where: 

string 


is l- to 8-EBCDIC characters to be searched for. 


X'string' 
_ is a 1- to 16-digit hexadecimal string to be searched for. The string must be in 
( : quotes and preceded by the letter X. 
; fromaddr 
is the 31-bit (4-byte) hexadecimal starting address for the search. 
toaddr 
is the 31-bit (4-byte) hexadecimal number that is the ending address for the 
search. 
increment 
is a 1- to 4-digit hexadecimal number to change the current address after each 
( match attempt. 
) 1 


is the default increment if none is specified. 


Usage Notes: 


1. All EBCDIC strings are truncated on the right to 8 characters. All hexadecimal 
strings are truncated on the right to 16 hexadecimal digits. 


2. The second quote of the X'string' operand is optional. 


( 3. The LOCATE subcommand may be reissued by pressing the ENTER key (“null 
“A line” subcommand). The from address (fromaddr) is updated using the current 
address and the increment, and the subcommand is then reissued. 


4. If the following conditions are true, use of the increment operand in the 
LOCATE subcommand can reduce search time by eliminating unwanted 
matches. 


e If the target string is at a fixed displacement in each entry of a data area, 
and each entry has a fixed length 


¢ Ifthe target string is at a fixed pony (fullword, doubleword, 16-byte, 
32-byte, and so on). 


For example, to check the beginning of each hex 20-byte entry from address hex 
4000 to hex 8000 for the character string ABCD, enter: 


locate abcd 4000 8000 20 


The data at the hex addresses 4000, 4020, 4040, ... 8000 is searched for the string 
ABCD until the first occurrence (if any) is reached. These addresses are the 
increment length (hex 20) apart. 
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5. The valid increment range is from hex | to 1000. 


6. If the LOCATE subcommand is placed in the &name table, the maximum string 
of 8 characters includes the hexadecimal identifier X with the hexadecimal char- 
acters with quotes (for example, X'13AB4'). 


7. If LOCATE is specified, the starting address must be less than the ending 
address; otherwise, an error message is issued. 


8. If LOCATEUP is specified, the starting address must be greater than the ending 
address. If it is not, an error message is issued. 


Rene: 


Provided the end of dump has not been reached, one full screen of data is presented, 
in both hexadecimal and EBCDIC. The target string is positioned on the first line at 
the hexadecimal location where the string begins. 


Sample Output: | aes 


Figure 57 illustrates the screen displayed when the subcommand LOCATE 
X'C5C8D20A' 900000 990000 8 is entered. This subcommand searches the dump 
from hex address 900000 up through address 9900000 searching for the hexadecimal 
string X'CSC8D20A'. The dump is stepped through by adding 8 bytes from the 
current address until either a match is found or the to address is reached. 


Note that the first occurrence of the string is on the first line of data at address 
0096B1C0. 


are! 


0096B1CO 
0096B1D0 
0096B1E0 
0096B1FO 
0096B200 
0096B210 
0096B220 
0096B230 
0096B240 
0096B250 
0096B260 
0096B270 
0096B280 
0096B290 
0096B2A0 
0096B2B0 
0096B2CO 
0096B2D0 
0096B2E0 
0096B2F0 
0096B300 
0096B310 
0096B320 
0096B330 
0096B340 
0096B350 
0096B360 
0096B370 
0096B380 


=—— 


C5C8D20A 
7508C5E2 
5890C8B8 
4740C1E4 
5830C5C4 
C21858F0 
70005810 
C8EOQDEF 
58B00A20 
82000008 
C690C580 
45B0C360 
45B0C360 
C70AC722 
8200C608 
470002AC 
0070C618 
45A0C314 
189C05CO 
D2070068 
C8F4D20D 
82000070 
C6E99004 
07FADZ203 
C6E94100 
9813C764 
58FOC8FC 
58FOC900 
C8C08830 


The subcommand entered 1s: 


lo x'c5c8d20a' 900000 990000 8 


7088C5CC 
D201750A 
45B0C378 
9501C5BC 
18421F55 
C8DOOQDEF 
C8D85820 
D7077000 
58FOC8E8 
82000018 
92400694 
8200C5F8 
8200C600 
41000039 
900F0180 
41C0C000 
D203C6EF 
980F0180 
4BCOC006 
C610D207 
C70AC743 
D5Q2C91A 
41000039 
C6EFC8F8 
00394580 
9849C770 
D505C910 
QODEFO7FB 
000C5030 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 < 
DISPLAY 0096B1C0 


D20A7093 
C5E4D204 
5E9SOC5BO 
4780C20A 
0£249501 
58F0C8D4 
C8DC4130 
700058F0 
58E008E0 
F342C690 
4110C680 
4110C6AE 
D203C6EF 
4110C6E9 
189C05C0 
D2070068 
C8FOQD20D 
82000068 
470002E4 
0070C618 
45A0(0314 
90044770 
4110C6E9 
D2QFC70A 
C3601B00 
98EFC5FO 
FQ04077B 
5090C7BC 
C7C84110 


> DumpType CP <=== 


C5D7D201 04 *EHK...E.K...EPK.* 
*. wESKsa EUR... <EW* 


744CC5E6 
5590C8C8 
5820C8CC 
C5BC4770 
ODEF4100 
000058F0 
C8E40DEF 
4DEQEA6E 
C86EDCO3 
4100002E 
4100003B 
C8ECD212 
45B0C360 
4BCOCO06 
C610D207 
C70AC735 
900F0180 
41C0C000 
D203C6EF 
980F0180 
C324D205 
45B0C360 
C7514110 
BFO37490 
82000620 
41200002 
18395F30 
C7BO58F0 


* es 


aavsloe ty 
Z..C- 


*)K.F.H8K.G.G... 


see ESR LS ESS SE a ee Seat eae 


Figure 57. Sample Output of a LOCATE Subcommand with the Increment Operand 
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PRINT Subcommand : 


Use the PRINT subcommand to print data displayed on your terminal by one of the 
DUMPSCAN subcommands. The format of the PRINT subcommand is as follows: 


subcommand 


Where: 
subcommand 
is a DUMPSCAN subcommand to be issued. Its results are printed and dis- 
played. | 2 
ON \ 
turns on the print switch to collect data for printing. 
OFF 
turns off the print switch, but does not close the virtual printer. 
CLOSE 
sends data from the virtual printer to the real printer, but does not turn the print 
switch off. 
9 if nS 
displays the print switch status (ON or OFF). NY 
Usage Notes: 
1. When the print switch is ON, all data displayed at the terminal is also written to 
the virtual printer. 
2. PRINT with no operands reissues the subcommand previously entered and 
prints the data. The data is not redisplayed at the terminal. 
3. The PRINT subcommand is not allowed in the &name table. | ie a 
4. CLOSE is automatically issued at the end of the DUMPSCAN session. A 


5. If the print switch is OFF and the print subcommand is issued, with or without 
an operand, the print switch is turned on for that operation, then turned off. If 
the print switch was ON, it is left on. 


6. PRT is a synonym for the PRINT subcommand. 
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QUIT Subcommand 


Use the QUIT subcommand to end the session and return to CMS. The format of 
the QUIT subcommand is as follows: 


Usage Note: 


The QUIT subcommand is equivalent to the HX subcommand. 
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REGS Subcommand 


Use the REGS subcommand to display registers, clocks, timer, and program status 
words for a specific processor. The format of the REGS subcommand is as follows: 


ieee | et 


Where: 


cpuaddr 
is a 1- to 4-digit hexadecimal number specifying the CPU address for which the 
information is to be displayed. 


Usage Notes: 


1. For System/370 virtual machine dumps, the output of the REGS subcommand 
also includes: 


¢ Channel status word (CSW) 
e Channel address word (CAW) 
¢ Interval timer 
¢ Current program status word (PSW). 
2. The REGS subcommand clears the screen prior to presenting data. 
3. Use the CPU subcommand to obtain the CPU addresses in the dump. 


4. If the cpuaddr operand is not specified, it defaults to the failing processor for CP 
dumps that are not stand-alone dumps, the IPL processor for stand-alone 
dumps, or the processor on which the CP VMDUMP command was issued for 
the virtual machine. 
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Sample Output: 


Figure 58 illustrates the output of the REGS subcommand for the failing processor. 
The subcommand entered 1s: 


regs 01 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 


REGS 01 
CPU ADDRESS - 0001 
GENERAL REGS 0 - 15 
00000000 40C5E7E3 00001201 033C0000 
00923000 809F6A80 00900000 00900000 
CONTROL REGS 0 - 15 
8OBOFE40 00800001 00000000 00000000 
00000000 0000000 00000000 00000000 
FLOATING POINT REGS 0 - 6 
00000000 00000000 00000000 00000000 


TOD CLOCK NOT AVAILABLE 
CLOCK COMPARATOR FFFFFFFF FFFFFOOO 
CPU TIMER 7FFFFFFE FFA66000 


EXT OLD 033C0000 80A27F5E 


INT CODE 1201 
INT CODE 0000 
INT CODE 0001 


SVC OLD 00000000 00000000 
PGM OLD 000C1000 80981B76 
MCH OLD 00000000 00000000 
I/0 OLD 00000000 00000000 


===> 


PREFIX REGISTER - 01CBO000 


80A27F5E 80000002 0000005) 01F505C0 
009F6270 00000018 809F6EFO O00A27A40 


00000000 00000000 48000000 00000000 
01C51721 00000000 5FOQ0000 00000000 


00000000 00000000 00000000 00000000 


EXT NEW 000CQ000 809A2290 
SVC NEW Q00CO000 809FBZB0 
PGM NEW OO0A0000 00009005 
MCH NEW QO0A0000 00009005 
1/0 NEW Q00CQ000 809B4518 


ILC 0004 


Figure 58. Sample Output of a REGS Subcommand 


Figure 59 illustrates the output of the REGS subcommand for a virtual machine 


dump. The subcommand entered 1s: 


regs 
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pil hcsabe er dat eh ec ibeshcloeetnetin a ee alain esse IVE ish i EAN, Pb egies gli desta test. Hep ATO aE Dock HSER Sc al or el ay es 


==>Dumpscan Release 2.0 <===> DumpName VMDUMPOQ1 < 


REGS 
CPU ADDRESS - 0000 
GENERAL REGS 0 - 15 
00000000 00002A30 000007A0 80000020 
QOQ0001C HOQOOOOO 008179D8 00000000 
CONTROL REGS @ - 15 
Q10000EO OQOQOOOO FFFFFFFF 00000000 
00000000 OQODO0EO OHOEOOOLO 00000000 
FLOATING POINT REGS 0 - 6 
. 00060000 DQODEDOO OHOEQODOO 00000000 


TOD CLOCK 9D0336E6 BEE7AA60 
CLOCK COMPARATOR Q0000000 00000000 
CPU TIMER FFFFFFOD E9BB4000 
INTERVAL TIMER 00000000 


EXT OLD 00000000 00000000 INT CODE 0000 
SVC OLD 000400C9 50801404 INT CODE OOFF 
PGM OLD 00040013 40020C80 INT CODE 0000 
MCH OLD 00000000 00000000 
1/0 OLD FFO4Q01F 008050A0 


===> 


===> Dumplype VM <=== 


PREFIX REGISTER - 00000000 


0B000848 
008179D8 


00000000 
00000000 


00000000 


ILC 0000 


E5D4C4E4 00002852 00000000 
FFFFFFFD 6080691E 00800938 


Q000G00O QODEDQ0N 00000000 
00000000 C2000000 00000200 


00000000 00000000 O0000000 


CSW 00004150 O0C000062 
CAW 00004140 
PSW 00040000 00817BE4 


EXT NEW 00040000 00817C80 
SVC NEW 00040000 00800B64 
PGM NEW 00040000 00000000 
MCH NEW 00060000 00000070 
I/O NEW 00040000 00805110 


Figure 59. Sample Output of a REGS Subcommand for a Virtual Machine Dump 
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RIOBLOK Subcommand 


Use the RIOBLOK subcommand to display summary information about real I/O 
control blocks. You can request information about a real device by real device 
number, logical real device number, real device block (RDEV) address, or by logical 
real device block address. 


The format of the RIOBLOK subcommand is as follows: 


RIOb1ok | FOR | device 


FOR | Ldevice 


AT address 


Where: 


FOR device 
is the 1- to 4-digit hexadecimal device number of the real device for which infor- 
mation is to be displayed. The keyword FOR may be omitted. 


FOR Ldevice 
is the 1- to 4-digit hexadecimal device number of the logical real device for 
which information is to be displayed. The L immediately precedes the logical 
real device number. The keyword FOR may be omitted. 


AT address 
is the 31-bit (4-byte) hexadecimal address of the real device block (RDEV) or the 
logical real device block address for which information is to be displayed. The 
address must be preceded by the AT keyword to distinguish it from a device 
number. | 


Usage Notes: 
1. The RIOBLOK subcommand is not supported for virtual machine dumps. 


2. You may enter a real device number or a logical device number without leading 
zeros. For example, to display information on logical real device hex OAFF, 
enter RIOBLOK FOR LAFF. 


3. The display screen is cleared upon every successful invocation of the subcom- 
mand. For example, whenever real device information 1s located and displayed, 
the display screen is cleared prior to presentation of the requested data. 


4. If information is to be displayed from a control block (other than the RDEV) 
that is not contained in the dump, NOT AVAILABLE appears in place of the 
control block data. For example: USER VMDBK USERID = NOT AVAIL- 
ABLE or LOCK OWNER VMDBK USERID = NOT AVAILABLE. 


5. If information is to be displayed about a device that does not have a currently 
active IORBK, NO ACTIVE IORBK is displayed in place of the IORBK fields. 
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Responses: 


Three types of information may be displayed for the RIOBLOK subcommand: 
¢ General device information. Displayed for each device. 


¢ Device-dependent information. Information about spooling, direct access 
storage devices, and display devices. 


e Active IORBK information. If the real device block had I/O active at the time 
of the dump, information from the active I/O request and response block 
(IORBK) is provided. 


For information on the corresponding dump data fields displayed by this command, 
refer to Appendix A. 


Sample Output: 


Figures 46 through 50 illustrate the output for the RIOBLOK subcommand with 
various device types specified. The subcommand entered for Figure 60 is: 


rio for e 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
REAL DEVICE QOOE SUBCHANNEL 0000 RDEV ADDRESS 00927770 
CLASS = 2Q SPOOL | FEATURE = 01 
TYPE = 22 3211 PRT MODEL = Q0 
USER VMDBK ADDR = 00900000 DEDICATED VDEV ADDR = 00000000 
USER VMDBK USERID = SYSTEM WAIT DEVICE CPEBK ADDR = 00000000 
LOCK OWNER VMDBK ADDR = 00000000 WAITING TASK QUEUE = 00000000 
LOCK OWNER VMDBK USERID RDEVAFLG = 84 
ACTIVE IORBK ADDR = 00000000 RDEVDFLG 
INTERVENTION REQ'D IORBK ADDR = 00000000 RDEVRFLG 
NEXT IMMEDIATE IORBK ADDR = 00000000 RDEVSTAT 


00 


DEVICE DEPENDENT INFORMATION: 

RSPBK ADDR = 009269E8 RELATIVE SPDBK NUMBER = 0000 
ACTIVE SPFBK ADDR = 00000000 ACTIVE FILE ID = 0 
CURRENT SPABK ADDR = 00000000 SPOOL CLASSES =A/ ////// 
RSPFLAG = 88 SILBK ADDR = 00000000 


NO ACTIVE IORBK 


SS > 


Figure 60. Sample Output of an RIOBLOK Subcommand for a Spooling Device 
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The subcommand entered for Figure 61 is: 
rio for 540 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
REAL DEVICE 0540 SUBCHANNEL 013F RDEV ADDRESS 00941FC8 
CLASS = 08 TAPE FEATURE = 42 
TYPE = 10 3420 MODEL = 06 
USER VMDBK ADDR = 00900000 
USER VMDBK USERID = SYSTEM 
LOCK OWNER VMDBK ADDR = 00000000 


DEDICATED VDEV ADDR = 00000000 
WAIT DEVICE CPEBK ADDR = 00000000 
WAITING TASK QUEUE = 00000000 
LOCK OWNER VMDBK USERID RDEVAFLG = 00 

ACTIVE IORBK ADDR = 00000000 RDEVDFLG = 00 

INTERVENTION REQ'D IORBK ADDR = 00000000 RDEVRFLG = 00 

NEXT IMMEDIATE IORBK ADDR = 00000000 RDEVSTAT = 80 


==<<=> 


( NO ACTIVE IORBK 


Figure 61. Sample Output of an RIOBLOK Subcommand for a Tape Device 


The subcommand entered for Figure 62 is: 
rio 440 


( | ==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
- REAL DEVICE 0440 SUBCHANNEL 011B RDEV ADDRESS 0093EF38 


CLASS = 04 DASD 

TYPE = 10 3350 

USER VMDBK ADDR 00900000 

USER VMDBK USERID = SYSTEM 

LOCK OWNER VMDBK ADDR = 00000000 

LOCK OWNER VMDBK USERID 

ACTIVE IORBK ADDR = 01F37000 
INTERVENTION REQ'D IORBK ADDR = 00000000 
NEXT IMMEDIATE IORBK ADDR = 00000000 


DEVICE DEPENDENT INFORMATION: 
SYSTEM CPVOL ENTRY = 009248B8 
VOLUME SERIAL ID = XAPK7 


ACTIVE TORBK INFORMATION: 
FCTL ACTL DVST SCST COUNT CCW ADDR 
IRB: 80404024040004000400000 01F371F0 


===> 


FEATURE = 82 

MODEL = 00 

DEDICATED VDEV ADDR = 00000000 
WAIT DEVICE CPEBK ADDR = 00000000 
WAITING TASK QUEUE = 00000000 
RDEVAFLG = 

RDEVDFLG 

RDEVRFLG 

RDEVSTAT 


NEXT LOWER IORBK ADDR = 00000000 
NEXT HIGHER IORBK ADDR = 00000000 


KEY FPI LPM CPA 
ORB: 08 CO CO 00000000 


Figure 62. Sample Output of an RIOBLOK Subcommand for a Device with an Active IORBK 
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The subcommand entered for Figure 63 is: 
rio 20 


| ==>Dumpscan Release 2.0 <===> DumpName CPDUMP01 <===> DumpType CP <=== 
REAL DEVICE 0020 SUBCHANNEL 000B RDEV ADDRESS 00927C10 


CLASS = 40 DISPLAY FEATURE = 00 

TYPE = 40 3278/3279 | MODEL = 02 

USER VMDBK ADDR = 90900000 DEDICATED VDEV ADDR = 00000000 
USER VMDBK USERID = SYSTEM WAIT DEVICE CPEBK ADDR = 00000000 
LOCK OWNER VMDBK ADDR = 00000000 WAITING TASK QUEUE = 00000000 
LOCK OWNER VMDBK USERID RDEVAFLG = 00 

ACTIVE IORBK ADDR = 00000000 RDEVDFLG = 00 

INTERVENTION REQ'D IORBK ADDR = 00000000 — RDEVRFLG = 00 

NEXT IMMEDIATE IORBK ADDR = 00000000 RDEVSTAT = 80 

DEVICE DEPENDENT INFORMATION: 

COMBK ADDR = 00000000 RDEVSFLG = 00 

TROBK ADDR = 00000000 RDEVTFLG = 20 


NO ACTIVE IORBK 


===> 


Figure 63. Sample Output of an RIOBLOK Subcommand for a Display Device 


The subcommand entered for Figure 64 is: 
rio at 927770 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
REAL DEVICE OQOE SUBCHANNEL 0000 RDEV ADDRESS 00927770 
CLASS = 20 SPOOL FEATURE = 01 
TYPE = 22 3211 PRT MODEL = 00 
USER VMDBK ADDR = 00900000 DEDICATED VDEV ADDR = 00000000 
USER VMDBK USERID = SYSTEM WAIT DEVICE CPEBK ADDR = 00000000 
LOCK OWNER VMDBK ADDR = 90000000 WAITING TASK QUEUE = 00000000 
LOCK OWNER VMDBK USERID RDEVAFLG = 84 
ACTIVE IORBK ADDR = 00000000 RDEVDFLG = 00 
INTERVENTION REQ'D IORBK ADDR = 00000000 RDEVRFLG Q 


Q 
NEXT IMMEDIATE TORBK ADDR = 00000000 RDEVSTAT = 00 


DEVICE DEPENDENT INFORMATION: 

RSPBK ADDR = 00926958 RELATIVE SPDBK NUMBER = 0000 
ACTIVE SPFBK ADDR = 00000000 ACTIVE FILE ID = 0 
CURRENT SPABK ADDR = 00000000 SPOOL CLASSES =A/ ////// 
RSPFLAG = 88 SILBK ADDR = 00000000 


NO ACTIVE IORBK 


mamma 


Figure 64. Sample Output of an RIOBLOK Subcommand with an Address Specified 
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SELECT Subcommand 


Use the SELECT subcommand to select the trace table entries you want to see. 
Reduction capability is enabled by a number of options. 


There are three forms of the SELECT subcommand. The format of the SELECT 
subcommand to select all of the trace entries follows: 


SELect ALL 


The format of the SELECT subcommand to enable or reset selection criteria follows: 


SELect CODE [RESET] { valuel[value2...] 
CPU ALL 


RDEV 


VDEV 
VMDBK 
USER 


The format of the SELECT subcommand to display the current selection criteria in 
effect follows: 


SELect QUERY | 
Where: 
CODE 


is the keyword to specify trace entries with the CODE values requested to be 
either SET or RESET. 


CPU 
is the keyword to specify trace entries with the CPU values requested to be 
either SET or RESET. 


RDEV 
is the keyword to specify trace entries with the RDEV values requested to be 
either SET or RESET. 


VDEV 
is the keyword to specify trace entries with the VDEV values requested to be 
either SET or RESET. 


VMDBK 
is the keyword to specify trace entries with the VMDBK address values 
requested to be either SET or RESET. 


USER | 
is the keyword to specify trace entries with the USERID values requested to be 
either SET or RESET. 


ALL 
is the keyword to specify that all trace entries for the trace tables will be dis- 
played. There is no selectivity when ALL is specified. 
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QUERY 
is the keyword to display current selection criteria in effect. If no operands are 
specified, QUERY is the default. No other operands may be specified with the 
QUERY keyword. | 


RESET 
allows the deletion of one or more selection values in effect for the type speci- 
fied. RESET should follow a keyword and precede the ALL or values param- 
eter. 


value(s) 
is the keyword for the specific value requested. There up are to 16 values 
allowed. 


Note: Ifa 17th value is requested, a message is issued to inform you that the 
maximum operand has been met. 


ALL 
is the keyword to specify that all values for a specific request should be dis- 
played. ALL is specified instead of values. If ALL is specified with one or 
more values, it will result in error message 801E. 


All is an implied RESET whenever you use it. The RESET operand need not be 
entered when ALL is the selected value. 


CODE 
is the 4-digit hexadecimal value of trace codes. Leading zeros are required. The 
last two digits of any of the codes can be specified as the character string * or ** 
to indicate that you want a range of trace codes. For example, for codes begin- 
ning with 15, you would enter either SELECT CODE 15** or SELECT CODE 
L5*. | | - 
Note: If you select 15* or 15** and a reset of 1501 is requested, you receive an 


error message. Conversely, if you select 1501, then request a reset for 15* or 
15**, you receive an error message. 


CPU 
is a 4-digit hexadecimal value. Leading zeros are not required. Each CPU 
address entered must be in the range of 0 to 3F. 


RDEV | 
is a value of up to four hexadecimal digits which represents the RDEV. Leading 
zeros are not required. 


VDEV | 
is a value of up to four hexadecimal digits representing the VDEV. Leading 
zeros are not required. Each device number must fall in the range of 0 to 
FFFF. 


VMDBK | 
is a value of up to eight hexadecimal digits representing the VMDBK address. 
Leadings zeros are not required. Each address must be in the of 0000 to 
T7FFFFO000 and on a 4K boundary. | 


USER 
is a keyword of up to 8 characters representing the USERID. 
Usage Notes: 


1. The dump viewing facility does not support trace table viewing in virtual 
machine dumps, so viewing is limited to CP and stand-alone dumps. 
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. You cannot make multiple combinations of reduction selection type keywords 
on the same invocation. Subsequent invocations of SELECT can add or delete 
reduction criteria for trace entries. 


. A maximum of 16 values can be set for each selection type. This number applies 
to the total number of invocations of SELECT. 


. A maximum of 16 values can be set for each of the selection types. This number 
applies to the total number of invocations of SELECT. 


. SELECT ALL will delete all values that have been saved due to prior selection 
criteria. 


. Enter: 
SELECT keyword RESET ALL 
to reset just the values for a specific keyword. 
. Enter: 
SELECT keyword RESET value 
to reset a specific value. 


. If any error occurs on the command line, you receive a message that your 
request will not be processed. 


. An individual trace entry may or may not contain a field of the same type speci- 
fied by the SELECT subcommand. Certain selection criteria are always present 
in a trace entry. The presence of other criteria are dependent on the trace 
entry’s architecture. 


SELECTION TYPE ALWAYS IN A TRACE ENTRY 


As a result, there are two main rules which apply to trace entry selection. 


¢ When only one selection type is in affect, only entries having that selection 
type and value are chosen. 


For instance: 


SELECT VMDBK 1000 2000 
TRACE 


Only entries which have VMDBK addresses of 1000 and 2000 are viewed. 


¢ Trace selection when multiple selection types were entered (combinations of 
CODE, VMDBK, RDEV, VDEV, CPU) follow these guidelines: 


a. Trace entries that contain fields for only some of the selection types you 
indicated, but whose value in those fields match the values you desig- 
nated, are chosen for output. 


b. A trace entry does not have to have all the selection types you specified 
in order to be chosen for output. 
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For instance: 


SELECT CODE 0C32 1000 0100 | 
SELECT RDEV 399 A 
SELECT VDEV 191 , 


TRACE 


In this case, trace entries to be selected for output would depend on the 
following: 


Responses: 


Trace entries with code 0C32 contain both an RDEV and VDEV 
value. Therefore, a trace entry of 0C32 must have an RDEV field 
value of 399 and a VDEV field value of 191 in order to be selected 
for output. 


Trace entries with code 1000 contain only an RDEV value. The 
VDEV selection value does not apply in this situation. Therefore, 
all trace entries of code 1000 with an RDEV field value of 399 are 
chosen for output. 


Trace entries with code 0100 have neither an RDEV nor VDEV —_ 
value. Therefore all trace entries of code 0100 are chosen for ‘ 
output. 


The following is the response to a request to determine the criteria that have been 
selected via the SELECT subcommand. Only those items which were actually 
selected are displayed. For example, if seven codes were selected, only seven codes 
are displayed. Each of the SELECT keywords can contain a maximum of 16 values, 


except the TIME keyword. The subcommand entered for Figure 65 is: 


select query 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPOQ1 <===> DumpType CP <=== 


CODE(S) 0100 
3000 


CPU(S) 0000 
ABCD 


RDEV(S) 0180 
0190 


VDEV(S) 0280 
5000 


SELECTION CRITERIA IN EFFECT 
0200 0300 0400 F400 3C00 3C(01 3C02 
3010 1501 1502 1503 1504 1505 1506 


0002 0004 0006 0007 0009 OOA3 FFFF ra 


FEDC EEEE BBBB CCCC 1111 2222 5555 oY 


0181 0182 0183 0184 0185 0186 0187 
0191 0192 0850 O00D O00C BODE 0000 


0282 0284 0286 0288 028A O28C O028E 
5001 5010 5100 5002 5003 5004 5005 


USER(S) SYSTEM OPERATPR MYMACH USEROO04 
PD2OFRJD AUTOLOG1 USERSYS RSCS 
USER1O USER11 USERI2  USER13 
USER14 USER15 USER16 ACCOUNT 


VMDBK(S) ©033A000 7FFFFO0O0 10000000 0033B000 
0045B000 OFFFFO0O 20000000 0012A000 
0067C000 OAAAADDO 30000000 00239000 
0099D000 OBBBBOOO 40000000 00348000 


Figure 65. Output from a SELECT QUERY request 
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SNAPLIST Subcommand 


Use the SNAPLIST subcommand to view a summary snaplist in a soft abend dump. 
This provides you with a list of addresses for the snapped data, and the buffer area 
or areas which contain a copy of the data at specified addresses. 


The format of the SNAPLIST subcommand is as follows: 


[__suartist | ot 


Usage Notes: 


1. Only soft abend dump types have snaplists. When you use the SNAPLIST sub- 
command on any other type of dump, you receive an error message. 


2. If you issue the SNAPLIST subcommand for a soft abend dump that does not 
have a snaplist, you receive an message informing you of this condition. 


3. If the status flags indicate that a certain field to be displayed is not complete, 
you receive information regarding the incomplete information in the output of 
your request. 


4. The information available to you from the SNAPLIST subcommand includes: 


¢ The address of snapped data and length, which enables you to locate the 
snapped area and the amount of information you need to display 


e The address of the dumped page from which snapped data comes, which 
may be used for comparative study. 


5. The SNAPLIST subcommand can display only the preserved data. If you 
specify that the abending module should preserve save areas and not snap data, 
you can only display save areas. 


Responses: 
The following is the response to the DUMPSCAN subcommand SNAPLIST, 
showing both module areas and save areas. This figure shows the SNAPLIST sub- 


command issued against a soft abend dump. 


The subcommand entered for Figure 66 on page 132 is: 


snaplist 
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Snapped data for dump SOFTDUMP 


Snapped 
Address 


30000 
20000 
3F800 
3F900 
60000 
100000 


Length 


AGO 
7CO 
100 
BAO 
080 
300 


Preserved Preserved 
~ Location 


FO2000 
FOCQOO 
F13C00 
F14C00 
F20600 
F20E00 


Snap Data Identifier (tag-id) 


LODSY SAVE 
USER AREA FOR VARIOUS STUFF 
SAVE AREA 1 FOR USER 


FRAME TABLE NUMBER EIGHT 
MOST OF MM3 


Preserved 
Savearea 
Location 


Snapped 
Savearea 
Address 


432100 
FDEC5200 
5678900 


F21200 = 
F21300 | Vo 
F21400 —_ 


Figure 66. Snapped Module and Save Areas 

The following is the response to the DUMPSCAN subcommand SNAPLIST, 
showing the work area is full and the snap data and the snap data identifier tag are 
located, at least partially, in non-CP pages. The save areas were not requested. - 


The subcommand entered for Figure 67 is: Ne a” 


snaplist 


==>Dumpscan Release 2.0 <===> DumpName SOFTDUMP <===> DumpType SOFTABEND <=== 
Snapped data for dump SOFTDUMP 


Snapped Preserved Preserved i. 
Address Length Location Snap Data Identifier (tag-id) 

30000 AQOQ FQ2000 LODSY SAVE 

20000 7CO FOCOOO USER AREA FOR VARIOUS STUFF 

3F800 100 Fi3COO0 =§=©SAVE AREA 1 FOR USER 

3F900 BAO F14C00 SAVE AREA 2 FOR USER 

60000 080 F20600 FRAME TABLE NUMBER EIGHT 

47000 004 FZ0E00 MOST OF 


*** Data and tag not preserved or partial - work area full 
*** Data and tag starts or ends in a non-CP page 


Snapped 
Savearea 
Address 


Preserved 
Savearea 
Location 


*** No snap save areas preserved 


==s==> 


Figure 67. SNAPLIST Truncated Due to Full Work Area 
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Additional SNAPLIST Responses: 


( | Creation and content of the soft abend dump 1s through the use of HCPABEND. 
— The SNAPLIST option of HCPABEND specifies the SDPL that describes the 
addresses and sizes of the data to be saved. The SNAPSAVE option of 
HCPABEND specifies whether the save areas are to be preserved. The following 
responses result from the various conditions that can be encountered depending on 
the use of HCPABEND. 


*** Snapped data page list starts in a non-CP page 


This is the response when the first snap data page is located in a non-CP page and 
no further processing of snap data is possible. 


( *** No snap data entries preserved 


This is the response when the snap data areas were not requested. 


*** Snaplist truncated - work area is full 


yee This is the response when the amount of snap data requested exhausts the preallo- 
( cated work area. 


*** List has been truncated - either a non-CP page or more than 256 


entries were encountered. 


This is the response when the last SPDL entry points to a non-CP page or the list of 
snap data addresses was greater than 256. 


a *** Save area page list starts in a non-CP page 


This is the response when SAVER13 in the SAVEBK points to a non-CP page. 


*** No snap save areas preserved 


This is the response when HCPABEND is specified with SAVEAREA = NO, the 
default. 
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*** Save area list truncated - work area full 


This is the response when the pre-allocated work area was exhausted by previous 
save area processing or by snap data area processing. 


*** Snap data not preserved - work area full 


This is the response when the the pre-allocated work area was exhausted by snap 
data area processing. 


*** Data and tag starts or ends in a non-CP page 


This is the response when an SPDL entry contains an SPDLID and an SPDLDA 
that point to data which is partially in non-CP pages. 


*** Data starts or ends in a non-CP page 


This is the response when an SPDL entry contains an SPDLDA that points to data 
which is partially in non-CP pages. 


6 AS 
a NN 


Nea” 
*** Tag starts or ends in a non-CP page 


This is the response when an SPDL entry contains an SPDLID that points to a tag 
which is partially in a non-CP page. 


*** Data not preserved or partial - work area full 
This is the response when the work area is full and the last snap area is incomplete. 
This is the response when the work area is full and the last snap id 1s incomplete. 
*** Data and tag not preserved or partial - work area full 


This is the response when the work area is full and the last snap id and snap data 
area are incomplete. 
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SYMPTOM Subcommand 


Use the SYMPTOM subcommand to display formatted symptom record information 
at your terminal. The format of the SYMPTOM subcommand is as follows: 


Usage Notes: 
1. The screen is cleared before the symptom record information is displayed. 


2. If a symptom string is not in the dump symptom record in the dump, it is not 
displayed. 


3. If the dump symptom record is missing or not readable, an error message 1s 
issued. 


Sample Output: 


Figure 68 illustrates the format of the output screen for a CP dump when the 
SYMPTOM subcommand is entered. The subcommand entered 1s: 


symptom 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
--~- SYMPTOM RECORD FOR CPDUMPO1 ---- 


TIME OF DAY CLOCK: 9DF469EC5E511000 CPU MODEL: 4381 
TIME ZONE: -5 CPU SERIAL: 999999 


DUMP TYPE: CPDUMP"" 


BASE OPERATING SYSTEM COMPONENT ID: VMHJ 
RELEASE: 2 
FEATURE: 


SYMPTOM STRING: 
AB/SPRGOO5 (ABEND CODE) 
PIDS /566430801 (COMPONENT ID) 
RIDS /HCPQRP (FAILING MODULE) 
REGS /QE008 (REGISTER/PSW DIFFERENCE) 
REGS /03046 (REGISTER/PSW DIFFERENCE) 


Figure 68. Output Format of a SYMPTOM Subcommand for a CP Dump 
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Figure 69 illustrates the format of the output screen for a VM dump when the 
SYMPTOM subcommand is entered. The subcommand entered is: 


symptom 


==>Dumpscan Release 2.0 <===> DumpName VMDUMPO1 <===> DumpType VM <=== 
---- SYMPTOM RECORD FOR VMDUMPOQ1 ---- 


TIME OF DAY CLOCK:  9DO330E6BEE7AA60 CPU MODEL: 3081 
TIME ZONE: -4 CPU SERIAL: 999999 


DUMP TYPE: VMDUMP 


BASE OPERATING SYSTEM COMPONENT ID: LEVEL2 " 
RELEASE: 2 
FEATURE: 


Figure 69. Output Format of a SYMPTOM Subcommand for a VM Dump 
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TRACE Subcommand 


Use the TRACE subcommand to display trace table entries. You can merge the 
trace table entries for one or all of the processors in the dump. The output resulting 
from this command is formatted in either hexadecimal or EBCDIC characters. 


[FOR] count | FROM oddress | FORMat 


HEX 


Where: 


FOR 
Indicates that the next operand (the count variable) is the number of trace table 
entries to be displayed. The keyword FOR may be omitted. 


count 
is a decimal number from | to 999 specifying the number of entries in the trace 
table to be displayed. 


FROM 
indicates that the next operand (the address variable) is the storage address from 
which trace entries are to be displayed. 


address 
is the 31-bit (4-byte) hexadecimal address from which the trace entries are to be 
displayed. The trace table entry address must be on a 32-byte boundary. 


FORMat 
indicates that the TRACE subcommand output should be formatted before 
being displayed. If the FORMAT option is not specified, the output is not for- 
matted before being displayed. 


HEX 
indicates that unformatted trace table entries should be displayed in 
hexadecimal. This is the default value. 


Usage Notes: 


1. The TRACE subcommand is not supported for virtual machine dumps. 


2. The default number of trace table entries displayed is dependent on the size of 
output screen you are using. Because of this, the FOR count operand is 
optional. 


3. If a count value entered is larger that the physical screen size, the XEDIT sub- 
commands FORWARD and BACKWARD can be used to scroll through the 
output. 


4. The operands HEX and FORMAT are mutually exclusive. If you enter these 
operands in any combination, you receive an error message. 


5. The keywords and associated operands may be specified in any order. 


6. Use the SELECT subcommand to control the trace table entries you want to 
view. Various trace entry reduction criteria can be enabled or reset with 
SELECT. 
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Responses: 
Depending on the operands specified, a display is presented of the trace table entries, a 
either in hexadecimal or formatted translation. 


Note: If you need an explanation of the trace codes and trace table entry contents, 
see the manual VM/XA SP CP Diagnosis Reference. 


Trace entries are displayed with the requested entry appearing last. 

If the HEX keyword is entered, one line of output is displayed for each trace entry. 
Each trace entry contains the following fields: address, CPU ID, time-of-day clock, 
trace code, and trace entry contents. The CPU address and the address of the most 


recent entry are displayed in the first line on the screen. If the output contains trace 
tables merged from two or more processors, the CPU address is ALL. | 


If the FORMAT keyword is entered, the output for each trace entry consists of up 
to three lines of data. They are as follows: 


Line #1. Trace code, CPU identifier, descriptive name, time-of-day clock, and 
address 


Line #2 Headings describing the format of the trace entry contents 
Line #3 ~—‘ Trace entry contents (up to 20 bytes of interpreted data) 
Line #4 __ Blank line. 


Figure 70 shows how the formatted output looks. 
Sample Output: 
The subcommand entered for Figure 70 is: 


trace form 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 


TRACE TABLE ENTRIES FROM 01C51700 TIME 07:53:50 

2COO CPU 0000 RETURN WITH SAVEAREA TOD 69E93BB6B000 ADR O1FA85CO 
RC CC SAVBK ADDR MOD/DISP CALLEE EXIT ADDR CALLEE 
QOACBO60 00 O1F40B00 CMD OO0E4 01D2320A CFC 

2301 CPU 0000 EXECUTE CP COMMAND TOD 69E93BB84000 ADR O1FA85E0 
TYPE FLAG BASE CFCTL CFCTL BASE CWAIT CWAIT COMMAND 
00 10 82 82 80 80 QUERY 

2800 CPU 0000 CALL WITH SAVEAREA TOD 69E93BB8E000 ADR 01FA8600 
PARM REG SAVBK ADDR CALLER REAL ADDR’ CALLER CALLEE VIRT ADDR 
00000000 O1F40B00 OOAZB69E CMD QOACB210 

2800 CPU 0000 CALL WITH SAVEAREA TOD 69E93BC8FO00 ADR 01FA8620 

oe PARM REG SAVBK ADDR CALLER REAL ADDR CALLER CALLEE VIRT ADDR 
( | 00000000 01F3C980 01D23304 CFC QOAF8A00 

0600 CPU 0000 OBTAIN FREE STORAGE (FREE) TOD 69E93BCDE000 ADR 01FA8640 
BLOCK ID DOUBLE WORDS BLOCK ADDR VMDBK ADDR MOD/DISP 
<<<< 00000028 01488008 00800000 QRP 0190 

0300 CPU 0000 PROGRAM INTERRUPTION TOD 69E93BCFDO00 ADR 01FA8660 
ILC INT CODE ADDRESS PGM OLD PSW 
0004 0005 QODDB888 QG00C1000 81CF6A8A 

( : 0100 CPU 0001 EXTERNAL INTERRUPTION TOD 69E93BD68000 ADR 01C51700 
- ILC INT CODE EXT OLD PSW 

0000 1201 033C0000 80A27F5E 


rea 


Figure 70. Sample Output of a TRACE Subcommand with the FORMAT Operand Specified 


Chapter 4. DUMPSCAN Reference 139 


er neneererearrene enone arraa erat at peer rg mimar re ara PUT TE Er Tse RCRA eae ae eT TT acai eae aca aaaiands al acini aa 
ERAN TTPO MRE MEALS BES CIE TTT TT We = aie Cv ae ty Made ete SO eh TID Mead eager eal Seedy ey ae Ma enn ee a aa ° - ae es 


Figure 71 illustrates the output of the TRACE subcommand with the default HEX 
operand. 


The subcommand entered for Figure 71 is: 


trace 


| ==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 


ae 3 " 
i 
tl 
iH } 
. / 
/ 
oo 7 Pa 


TRACE TABLE ENTRIES FROM 01C51700 


ADDRESS 

01FA8340 
01FA8360 
O1FA8380 
O1FA83A0 
O01FA83CO 
01FA83E0 
01FA8400 
01FA8420 
01FA8440 
01FA8460 
01FA8480 
O01FA84A0 
01FA84CO 


| O1FA84E0 


O1FA8500 
O1FA8520 
O1FA8540 
01FA8560 
O01FA8580 
O1FA85A0 
O1FA85CO 
O1FA85E0 
O1FA8600 
O01FA8620 
O1FA8640 
01FA8660 
01C51700 


====> 


CPU 

0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0060 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0001 


TOD CLOCK 

69£93B8B2000 
69£93B8C1000 
69E93B903000 
69E93B910000 
69E93B920000 
69E93B935000 
69£93B944000 
69£93B956000 
69£93B963000 
69E93B979000 
69£93B989000 


69E93B9BCO00 


69E93B9C8000 
69£93B9E3000 
69E93B9EFOO0 
69E93B9FCO00 
69£93BA11000 
69E93BA1D000 
69E93BA3B000 
69E93BA4F000 
69E93BB6B000 
69E93BB84000 
69E93BB8E000 
69£93BC8F000 
69E93BCDE000 
69E93BCFDO00 
69E93BD68000 


CODE 
2800 
FF20 
1030 
FF21 
3600 
3310 
3600 
3310 
2C00 
3300 
3600 
2800 
2C00 
3310 
2800 
2C00 
2800 
2C00 
2800 
2800 
2C00 
2301 
2800 
2800 
0600 
0300 
0100 


008061F8 
00000001 
0022000D 
00000000 
4D004000 
E4C34040 
40004002 
£4C34040 
00000000 
D2C34040 
40004000 
00000000 
OO9AFAZO 
£4C034040 
00000000 
00986C20 
00000000 
OOAZB6FO 
00000000 
00000000 
OOACBO60 
00000000 
00000000 
00000000 
4c4c4cac 
00800000 
00000000 


00C7D9C6 
C9D6C960 
01F42D88 
C9D6C460 
00C9D6D3 
00000001 
00C7D9C6 
00000001 
O0OD8C3D6 
004D3728 
00C3C6D4 
00C3C6D4 
10C9D6C1 
00000028 
00C3C6D4 
00C3C6D4 
00C3C6D4 
00C3D4C4 
00C3C6D4 
00C3D4C4 
Q0C3C6C3 
00000010 
00C3D4C4 
00C3C6C3 
00000028 
00040005 
40C5E7E3 
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O1FAFA80 
00927ED8 
00927E60 
00927ED8 
00800000 
00800000 
00800000 
00800000 
01F38F80 
00800000 
00800000 
01F40B00 
01F40B00 
00800000 
01F40B00 


01F40B00 


01F38F80 
01F38F80 
Q01F38F80 
01F40B00 
01F40B00 
82828080 
01F40B00 
01F3C980 
01488008 
O0ODDB888 
00001201 


Figure 71. Sample Output of a TRACE Subcommand in Hexadecimal 


TIME 07:53:50 
KRKEKEKEKKERER TRACE ENTRY CONTENTS KKEEKEKKEERE 


80A32414 
00800000 
00CO8000 
00800000 
00000000 
01F3C980 
00000000 
01F40B00 
80986B2C 
01F38F80 
00000000 
80986152 
80986152 
O01F38F80 
809864D8 
809864D8 
80986356 
80986356 
80986600 
80A2B614 
80A2B614 
D8E4C5D9 
80AZB69E 
81D23304 
00800000 
000C1000 


033C0000 


009B3F08 
809B3F56 
0080618 
809B3F56 
809B2EC2 
00A31818 
80A3248C 
OOA49E9A 
SOA49EFA 
80986B4E 
80986B54 
OO9AFAZ0 
SO9AFAB2 
0098620 
00986C26 
80986CBC 
OOAZB6FO 
80A2B75C 
00A2B590 
OOACBOQ60 
81D2320A 
F8404040 
QOACB210 
OOAF8A00 
81CF6B30 
S1CF6A8A 
80A27F5E 
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VIOBLOK Subcommand 


Use the VIOBLOK subcommand to display summary information about virtual I/O 
control blocks. When you issue this subcommand, the system displays information 
about a virtual device or subchannel for the userid specified. You may also request 
information by the virtual device block (VDEV) address. 


The format of the VIOBLOK subcommand is as follows: 


VI0blok FOR device userid 
FOR SCH subchannel userid 
AT address 
Where: 
en FOR device 
( | is a 1- to 4-digit hexadecimal device number of the virtual device for which 


information is to be displayed. You may enter only one virtual device number. 
The keyword FOR may be omitted. 


FOR SCH subchannel 
is the 1- to 4-digit hexadecimal number of the virtual subchannel for which 
information is to be displayed. You may enter only one subchannel number. 
You must precede the subchannel number by the SCH keyword to distinguish it 
from a device number. The keyword FOR may be omitted. 


| userid 
( is the 1- to 8-character userid of the virtual machine for which virtual device 
information is to be displayed. You may enter only one userid. 
AT address 


is the 31-bit (4-byte) hexadecimal address of the virtual device block (VDEV) for 
which information is to be displayed. You may enter only one address. You 
must precede the address by the AT keyword to distinguish it from a device 
number. 


( : Usage Notes: 
, 1. The VIOBLOK subcommand is not supported for virtual machine dumps. 


2. You may enter the device number, subchannel number, and address operands 
without leading zeros. 


3. If either the VIOBLOK or VMDBK subcommand has been invoked with a 
userid during the current DUMPSCAN session, the userid defaults to the virtual 
machine whose VMDBK was last requested by either of these subcommands. 


If neither the VIOBLOK nor VMDBK subcommand has been invoked during 
the current DUMPSCAN session, the userid defaults to the system operator. If 
the system operator cannot be determined, then you must not allow the userid to 
default. 


4. If information is to be displayed from a control block (other than VDEV) that is 
not contained in the dump, NOT AVAILABLE appears in place of the control 
block data. 
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For example, if the VMDBK for the user cannot be found, USER MODE = 
NOT AVAILABLE is displayed and the top line includes USER NOT AVAIL- 
ABLE. | 


If the RDEV cannot be found, then REAL DEVICE NUMBER = NOT 
AVAILABLE 1s displayed. 


5. If information is to be displayed about a device that does not have currently 
active 1/0, NO ACTIVE IORBK is displayed in place of the IORBK fields for 
existing VIOBLOKs. 


6. This subcommand clears the screen for existing VIOBLOKs prior to displaying 
the requested information. 


7. If you specify a userid for which more than one VMDBK is found, the 
VIOBLOK subcommand terminates with message 624I (USERID userid IS A 
DUPLICATE USERID). You may still display virtual I/O information about 
the desired userid by using the following procedure: 


a. Issue the VMDBK LIST subcommand to determine the address of the Pa 
desired VMDBK. 


b. Once you know the address of the VMDBK for the required userid, issue 
the VMDBK AT address subcommand to set the default VMDBK. 


c. Issue the VIOBLOK subcommand without a userid for the devices for which 
you want to view information. 


Responses: 


There are three types of information that the display for the VIOBLOK may include: a 
e General device information. Displayed for each device. | 


e Device-dependent information. Information about spooling, direct access 
storage devices (DASD), and channel-to-channel adapter (CTCA) devices. 


e Active IORBK information. If the virtual device block had I/O active at the 
time of the dump, information from the active I/O request and response block 
(IORBK) is provided. 


For information on the corresponding dump data fields displayed by this subcom- 
mand, refer to Appendix B. 


Sample Output: 


Figure 72 on page 143 illustrates the screen you see when using the VIOBLOK sub- 
command. The subcommand entered is: 


vioblok at lc4acf0 
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==>Dumpscan Release 2.0 <===> DumpName CPDUMPOQ1 <===> DumpType CP <=== 
VIRTUAL DEVICE 0191 SUBCHANNEL 0007 VDEV ADDRESS 01C4ACFO USER OPERATOR 
CLASS = 04 DASD RDEV ADDR = 0094F488 
TYPE = 40 3330/3333 REAL DEVICE NUMBER = 0830 
USER VMDBK ADDR = O01F2E000 WAITING TASK QUEUE = 00000000 
USER MODE = XA COMPLETION TASK QUEUE = 00000000 
LOCK OWNER VMDBK ADDR = Q0000000 
ACTIVE IORBK ADDR = 00000000 VDEVAFLG = 00 VDEVIOP1 = 00 
PENDING INTERRUPT IORBK ADDR = 00000000 VDEVDFLG 


START /RESUME PENDING IORBK ADDR = 00000000  VDEVSTAT 
SENSE IORBK ADDR = 00000000 VDEVWAIT 


DEVICE DEPENDENT INFORMATION: 
MINIDISK STARTING CYLINDER = MDISK ADDR = 00000000 
MINIDISK ENDING CYLINDER = 


NO ACTIVE IORBK 


===> 


Figure 72. Sample Output of a VIOBLOK Subcommand 


Figures 59 through 62 illustrate the screens you see when information for various 


devices are requested using the VIOBLOK subcommand. The subcommand entered 


for Figure 73 is: 


vio for c operator 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
VIRTUAL DEVICE 000C SUBCHANNEL 0001 VDEV ADDRESS 01C4A338 USER OPERATOR 


CLASS = 20 SPOOL RDEV ADDR = 00000000 

TYPE = 82 2540 RDR REAL DEVICE NUMBER = 0000 

USER VMDBK ADDR = O1F2E000 WAITING TASK QUEUE = 00000000 

USER MODE = XA COMPLETION TASK QUEUE = 00000000 

LOCK OWNER VMDBK ADDR = 00000000 

ACTIVE IORBK ADDR = 00000000 VDEVAFLG = 20 VDEVIOP1 = 00 

PENDING INTERRUPT IORBK ADDR = 00000000 VDEVDFLG = 00 

START/RESUME PENDING IORBK ADDR = 00000000  VDEVSTAT = 00 

SENSE IORBK ADDR = 00000000 VDEVWAIT = 00 

DEVICE DEPENDENT INFORMATION: 

VDSBK ADDR = 01C4A408 VSPBK ADDR = 01C4A448 

VPXBK ADDR = 00000000 CURRENT SPABK ADDR = 00000000 
ACTIVE SPFBK ADDR = 00000000 


NO ACTIVE IORBK 


= 


Figure 73. Sample Output of a VIOBLOK Subcommand for a Spooling Device 
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For Figure 74, the subcommand entered is: 


vio sch 04 operator 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPOQ1 <===> DumpType CP <=== 

VIRTUAL DEVICE 0490 Se Pe ReNner 0004 VDEV ADDRESS 01C4A920 USER OPERATOR 
CLASS = 04 DASD RDEV ADDR = 0093C910 
TYPE = 04 3380 | REAL DEVICE NUMBER = 0393 

USER VMDBK ADDR = O01F2E000 WAITING TASK QUEUE = 00000000 
USER MODE = XA COMPLETION TASK QUEUE = 00000000 
LOCK OWNER VMDBK ADDR = 00000000 
ACTIVE IORBK ADDR = 00000000 VDEVAFLG = 00 VDEVIOP1 = 00 
PENDING INTERRUPT IORBK ADDR = 00000000 VDEVDFLG = 80 


START/RESUME PENDING IORBK ADDR = 00000000 VDEVSTAT = 00 
SENSE IORBK ADDR = Q0000000 VDEVWAIT = 00 


DEVICE DEPENDENT INFORMATION: 
MINIDISK STARTING CYLINDER = 
MINIDISK ENDING CYLINDER = 


MDISK ADDR = 00000000 


NO ACTIVE IORBK 


==> 


Figure 74. Sample Output of a VIOBLOK Subcommand for a DASD Device 


For Figure 75, the subcommand entered is: 


vio 901 flysysl 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
VIRTUAL DEVICE 0901 SUBCHANNEL O008F VDEV ADDRESS 004D75FO USER FLYSYS1 
CLASS = 40 DISPLAY RDEV ADDR = 00000000 


TYPE = 80 3277 REAL DEVICE NUMBER = 0000 

USER VMDBK ADDR = 00893000 WAITING TASK QUEUE = 00000000 
USER MODE = 370 COMPLETION TASK QUEUE = 00000000 
LOCK OWNER VMDBK ADDR = 00000000 

ACTIVE IORBK ADDR = 00000000 VDEVAFLG = 00 VDEVIOP1 = 00 
PENDING INTERRUPT IORBK ADDR = 00000000 VDEVDFLG = 00 

START /RESUME PENDING IORBK ADDR = 90000000 VDEVSTAT = 00 

SENSE IORBK ADDR = 00000000 VDEVWAIT = 00 


NO ACTIVE IORBK 


=== 


Figure 75. Sample Output of a VIOBLOK Subcommand for a Display Device 
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For Figure 76, the subcommand entered is: 


vio 4F8 rscs 


==>Dumpscan Release 2.0 <===> DumpName CPDUMP0O1 <===> DumpType CP <=== 
VIRTUAL DEVICE 04F8 SUBCHANNEL 0009 VDEV ADDRESS 01329860 USER RSCS 
CLASS = 02 SPECIAL RDEV ADDR = 00D94248 

TYPE = 80 CTCA REAL DEVICE NUMBER = 088C 
USER VMDBK ADDR = 01774000 WAITING TASK QUEUE = 00000000 
USER MODE = 370 COMPLETION TASK QUEUE = 00000000 
LOCK OWNER VMDBK ADDR = Q0000000 

ACTIVE IORBK ADDR = O1F4E6C8 VDEVAFLG = 08 VDEVIOP1 = 00 
PENDING INTERRUPT IORBK ADDR = 00000000 VDEVDFLG 

START/RESUME PENDING IORBK ADDR = Q0Q00000 VDEVSTAT 

SENSE IORBK ADDR = 00000000 VDEVWAIT = 


7 a DEVICE DEPENDENT INFORMATION: 
( X-SIDE CACBK ADDR = 00000000 


ACTIVE IORBK INFORMATION: 
FCTL ACTL DVST SCST COUNT CCW ADDR KEY FPI LPM CPA 
IRB: 80404044040800000000001 (1F400B0 ORB: 00 £0 80 OQ1F400A8 
IORU: 00 28 ~~ #FF 


=<=—=> 


Figure 76. Sample Output of a VIOBLOK Subcommand for a Device with an Active IORBK 
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VMDBK Subcommand 
Use the VMDBK subcommand to scan the VMDBK chain and display summary 
information including the userid and VMDBK address for each user logged on to 
the system at the time of the dump. You can also use this subcommand to display 
selected fields from a specific user’s VMDBK, or display a summary of a single user 
or VMDBK. The three forms of the VMDBK subcommand follow. 


To provide a list of users in the dump, use the following command: 


To provide a summary of information for a specific user, use the following 
command: 


FOR userid 


AT address 


To provide the values and descriptions of specific fields in the VMDBK for a speci- 
fied user, use the following command: 


| FOR | userid | FIELD | fieldl pam | 


AT address 


Where: 


LIST 
is an optional keyword operand. If you enter it, you see the userid, the 
VMDBK address, and the key fields of the VMDBK for each user on the global 
cyclic list. If the LIST operand is used, no other operands are allowed. This is 
the default if you do not enter any operands. 


FOR userid 
1 to 8 characters specifying the single userid for which the VMDBK data 1s 
desired. FOR is an optional keyword indicating that the following operand 1s 
the userid. 


AT address 
is the 31-bit (4-byte) hexadecimal address of the VMDBK that is to be viewed. 
The address must be on a 4K-byte boundary. It must also be preceded by the 
AT keyword operand. 


FIELD field1 
is a defined field name in the VMDBK that is to be displayed with a description. 
A list of fields separated by blanks may be entered (field2 field3 ....). At least 
one field name must be entered if the FIELD operand is entered. FIELD is an 
optional keyword operand. 
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Usage Notes: 


1g 
Ps 
3. 


The VMDBK subcommand is not supported for virtual machine dumps. 
You may omit leading zeros on the input VMDBK address. 


If the userid is LIST, AT, FOR, FIELD, or if it begins with the characters 
VMD, the keyword FOR must be specified preceding the userid to distinguish it 
from a VMDBK field name. 


When using the FIELD operand, there is no limit to the number of fields that 
may be specified other than the maximum length of the input buffer. 


. You need not specify a userid or address. The default userid is one of the 


following: 


e The virtual machine whose VMDBK was last requested by either the 
VMDBK or VIOBLOK subcommands during the current DUMPSCAN 
session. 


¢ The system VMDBK, if this is the first time the VMDBK subcommand has 
been issued and the VIOBLOK subcommand has not been issued. 


Once you enter the VMDBK subcommand with the userid or address specified, 
you may continue to display fields from that VMDBK by entering the desired 
field names. The subcommand name, VMDBK, and the userid or address fields 
may be omitted after they are initially entered. 


For example, if you enter: 
vmd for userl field vmdmode 

and then wish to view the VMDBK type, enter: 
vmdtype 

The output shows the VMDBK type for USERI. 


When you specify no operands, the LIST operand is assumed and the output 
consists of the userid, the VMDBK address, and some key fields for each 
VMDBK in the dump. 


The following fields are displayed if the default LIST operand is used. 


Field Length Description 
VMDUSER 8 User logon identification 
VMDMODE 1 Guest machine mode controls 
VMDSTY PE 2 Supplement of the VMDMODE field 
VMDSLIST 1 Scheduling list definition 
VMDSTATE 1 Scheduler/dispatcher state 
VMDICODE 1 Interception event code 
VMDCOMND 8 The last CP command executed 
VMDGSTAT 1 The guest virtual running status 
VMDWSTAT 1 Pseudo-wait conditions 
VMDOSTAT i Virtual machine operating 
status 
VMDRSTAT 1 Running blockage status 
VMDCFCTL 1 Console function controls 


VMDCFLAG 1 Console function status flags. 


The VMDBK address appears in the leftmost column of the output. 
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9. The following fields are displayed if a userid or a VMDBK address is used. 


Field Length Description ff ~ 
‘ey 
VMDUSER 8 User logon identification 
VMDMODE 1 Guest machine mode controls 
VMDSTYPE 2 A supplement of the VMDMODE field 
VMDPSW 8 The guest PSW 
VMDTY PE i The VMDBK type 
VMDCOMND 8 The last CP command executed 
VMDCFLAG 1 The console function status flag 
VMDCFCTL 1 Console functions controls 
VMDPCL 4 Authorized privilege classes 
VMDINST 6 An intercepted instruction 
VMDICODE 1 The interception event code 
VMDCPUDS 2 The host CPU address on which the user 
was last dispatched | 
VMDSLIST 1 A scheduling list definition 
VMDSTATE 1 A scheduler/dispatcher state a 
VMDIOACT 4 The number of I/0 operations outstanding 4 
VMDWVDEV 4 The address of VDEV for the status 
response 
VMDWRKLC 4 Local work bits 
VMDWRKCS 4 The compare-and-swap work bits 
field 
VMDGS TAT 1 The guest virtual running status 
VMDRSTAT 1 The running blockage status 
VMDGPRS 64 Guest general purpose 
registers Se 
VMDCRS 64 Guest control registers Q-15. , a 2 
10. If you specify a userid for which more than one VMDBK is found, the VMDBK 
subcommand terminates with message 624I (USERID userid IS A DUPLICATE 
USERID). You may still display VMDBK information about the desired userid 
by using the following procedure: 
a. Issue the VMDBK LIST subcommand to determine the address of the 
desired VMDBK. 
b. Once you know the address of the VMDBK for the required userid, issue wee 
the VMDBK AT address subcommand. L 


Sample Output: 


Figure 77 on page 149 illustrates the output you receive when you enter the 
VMDBK subcommand using the default LIST operand. In the dump, you receive a 
list of all of the users along with their VMDBK address and some key fields. The 
subcommand entered is: 


vmdbk or vmdbk list 
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==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
VMDBK LIST FOR DUMP CPDUMPO1 

LOCAL SCHED INTERCPT LAST *VMD-STAT** *VMDCF** 
ADDRESS USER MODE VMDBK LIST-ST COMMAND GS-WS-OS-RS CTL-FLAG 
00900000 SYSTEM 00 DISP 2C vuncrert 980 00 00 40 04 00 
01C06000 DISKACNT 370 DORM 00 MESSAGE 00 00 44 40 03 00 


O1FZ2EO00 OPERATOR XA DORM 00 SET 60 00 CO 40 06 00 

00800000 MVSXAR XA DISP 4D QUERY 00 00 40 40 82 00 
V=R 

01C1C000 AUTOLOG1 370 DORM 00 SLEEP 00 00 44 40 03 00 

01C11000 EREP 370 DORM 00 SET 00 00 44 00 O01 00 


===> 


Figure 77. Sample Output of a VMDBK Subcommand with the LIST Operand 


( 7 Figure 78 illustrates the output you receive using the VMDBK subcommand with a 


userid or an address specified. The subcommand entered is: 


vmdbk for erep or vmdbk at 01c11000 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
VMDBK FOR USER EREP AT 01C11000 | 


MACHINE: CONSOLE FUNCTION: 
ps MACHINE MODE = 370 LAST COMMAND = SET 
( PSW = FFO60000 018D700F VMDCFLAG = 00 


VMDTYPE = 15 USER VMDBK VMDCFCTL = 01 
PRIVILEGE CLASSES = 46000000 
INTERCEPTED EVENT: VMDINST 000000000000 
VMDICODE = 00 GUEST IS BETWEEN INSTRUCTIONS 

DISPATCH: VMDCPUDS = 0000 | 

VMDSLIST = 0B ON DORMANT LIST 

VMDSTATE = 00 VMDBK IS IDLE 
VMDIOACT = 00000000 VMDWRKLC = 00 00 00 00 VMDGSTAT = 00 

or VMDWVDEV = 00000000 VMDWRKCS = 00 00 00 00 VMDRSTAT = 00 
( GENERAL REGISTERS 


00-07 O0000001 FFFDF230 Q0000001 00000004 800Z20DEC O0O20DD0 500201D4 80020A5E 
08-15 O0020F10 00E55630 00007000 00005680 OOE5A5F8 00002048 OOED1F96 00000000 


CONTROL REGISTERS . 

00-07 01000061 00000000 FFFFFFFF 00000000 00000000 O0000000 00000000 00000000 
08-15 00000000 00000000 BOOH000N 00000000 HNHD000N QOG000O0 C2000000 00000200 
NUMBER OF OTHER VMDBKS IN LOCAL LIST = 00000000 


===> 


Figure 78. Sample Output of a VMDBK Subcommand with a Userid or an Address Specified 
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Figure 79 is an example of the output you receive when you specify a userid plus - 
specific VMDBK fields. The subcommand entered is: 


vmd for erep field vmdpsw vmdchc vmddevct 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPQ1 <===> DumpType CP <=== 
VMDBK AT 01C11000 FOR EREP 


OFFSET FIELD NAME DATA | DESCRIPTION 

000118 VMDPSW FFQ60000 OOES5A63A GUEST PSW 

0005CO VMDCHC 01C11888 POINTER TO CHCBK 

QOO5CE VMDDEVCT 0008 COUNT OF DEFINED DEVICES 


== 


Figure 79. Sample Output of a VMDBK Subcommand with a Userid and VMDBK Fields Specified 


Figure 80 is an example of the output you receive when you specify an address plus 
specific VMDBK fields. The subcommand entered is: 


vmd at 1c11000 field vmduser vmdntmod vmdwpend 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPOQ1 <===> DumpType CP <=== 


VMDBK AT 01C11000 FOR EREP 


OFFSET FIELD NAME DATA DESCRIPTION 

000080 VMDUSER EREP USER LOGON IDENTIFICATION 

Q002A0 VMDNTMOD IC INTERCEPTION CODE 36 MODIFIER 
HOST PAGE FAULT ON USER PAGE 

Q0002A1 VMDWPEND 00 WORK PENDING STATUS 


===> 


Figure 80. Sample Output of a VMDBK Subcommand with an Address and VMDBK Fields Specified 


Figure 81 is an example of the VMDBK subcommand with only VMDBK fields 
specified. The VMDBK information displayed is for the same VMDBK specified in 
the previous issuance of the VMDBK subcommand. The subcommand entered 1s: 


vmdbk vmduser vmdntmod vmdwpend 


==>Dumpscan Release 2.0 <===> DumpName CPDUMPO1 <===> DumpType CP <=== 
VMDBK AT 01011000 FOR EREP 

OFFSET FIELD NAME DATA DESCRIPTION 

000080 VMDUSER EREP USER LOGON IDENTIFICATION 


| @002A0 VMDNTMOD 1C INTERCEPTION CODE 36 MODIFIER 
HOST PAGE FAULT ON USER PAGE 
Q002A1 VMDWPEND 00 WORK PENDING STATUS 


== 


Figure 81. Sample Output of a VMDBK Subcommand with Only VMDBK Fields Specified 
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VPAIR Subcommand 


Use the VPAIR subcommand to view the contents of a specific even-odd pair of 
vector registers or a designated number of vector elements if that information is 
available ina VM dump. The format of the contents displayed is compatible with 
that from CP’s DISPLAY command. 


The format of the VPair subcommand is as follows: 


VPair 
regl| - | reg2 ,eltl| - | elt2 CPU xx | 
®; : | END : | END 
{.}1 regent {.}| eltcnt 
END END 
Where: 
regl 


specifies the vector register pair whose contents are to be displayed. reg/ may be 
either an even decimal number from 0 to 14 or an even hexadecimal number 
from 0 to E. The number specified represents the first or only vector register 
pair whose contents are to be displayed. When specifying the register pair, use 
the number of the even register in the even-odd pair. Register 0 is the default. 


-or: 
indicates that a range of vector register pairs is to be displayed. 


reg2 
represents the last vector register pair whose contents are to be displayed. reg2 
may be either an even decimal number or an even hexadecimal number from 0 
to E. reg2 must be equal to or greater than reg]. reg2 must also be the even 
register of an even-odd pair. 


END 
is the default value for reg2. If you select END, or if it serves as the default, all 
register pairs from the pair specified by reg/ to register pair 14-15 are displayed. 


indicates that a count of vector register pairs is to be displayed. 


regcnt 
specifies the number of vector register pairs whose contents are to be displayed. 
regent is a number from 1 to 8. The range indicated by reg/ and regent cannot 
exceed the last valid register pair (that is, registers 14-15). 


END 
is the default value for regent. If you select END, or if it serves as the default, 
the contents of all register pairs from the pair specified by reg/ to register pair 
14-15 are displayed. 
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indicates that a register element specification follows. If you omit both the 
comma and element specification, the contents of element 0 are displayed. 


eltl 
represents the first or only vector element of a register pair to be displayed. e/t] 
is a hexadecimal number from 0 to one less than the section size. 
- or: 
indicates that a range of vector elements is to be displayed. 
elt2 | 
represents the last element of a register pair whose contents are to be displayed. 


elt2 is a hexadecimal number from 0 to one less than the section size. e/t2 must 
be equal to or greater than e/t/. 


END 
is the default value for e/t2. If you select END, or if it serves as the default, all 
vector elements from the element specified by e/t/ to the last element of the reg- 
ister pair designated are displayed. 


indicates that a count of vector elements is to be displayed. 


eltcnt 
indicates the number of elements whose contents are to be displayed. eltcnt is a 
hexadecimal number from 1 to the section size. The range indicated by e/t/ and 
eltcnt cannot exceed the maximum number of elements. 


END 
is the default value for e/tcnt. It calls for the display of the contents of all vector 
elements of the register pair, starting with the element specified by e/t/ and 
including the last element of the register pair. 


CPU xx 
is the address of the processor for which the vector register pair information is 
to be displayed. xx is a hexadecimal number between 0 and 3F. If you do not 
specify an address, the requested information is displayed for the processor on 
which the dump was initiated. 


Usage Notes: 


1. When you specify ranges for vector register pairs or elements of a vector register 
pair, the command cannot contain embedded blanks. For example, the fol- 
lowing range specifications are invalid: 


VP @ - 8 
or 
VP 0-8, 1 - 200 
The following range specifications are valid: 
VP 0-8 
or 
_ VP 0-8,1-200 


2. You can use the dump viewing facility's CPU subcommand to find the address 
of each processor contained in the dump. 
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gore 


Example: 


Figure 82 shows the screen output you would receive if you entered the VPAIR 
command. The subcommand entered is: 


vpair 8-a,1-4 


==>Dumpscan Release 2.0 <===> DumpName VMDUMPO1 <===> DumpType VM <=== 
VECTOR REGISTER(S) FOR CPU 02 


VP08,001 80016D2590016D25 -48118113640388005 9 

VPQ8,002 80026D2590026D25 -81853147066580229 9 

VP08,003 80036D2590036D25 .11558818049277245 8 

VPQ8,004  80046D2590046D25 . 14932321391896467 8 

VPOA,001 AQ016D25B0016D25 - 16373767496610430 0 

VPOA,002 A00Q26D25B0026D25 -27853204519032096 0 

ia_ VPOA,003 A0Q36D25B0036D25 .39332641541453762 0 
( VPOA,004 AQ046D25B0046D25 . 50812078563875428 0 


===> 


Figure 82. Output from a VPAIR Subcommand 
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VREG Subcommand 


Use the VREG subcommand to view the contents of a specific vector register or a 
designated number of vector elements if that information is available in a VM dump. 
The format of the contents displayed is compatible with that from CP’s DISPLAY 
command. | 


The format of the VReg subcommand is as follows: 


regcnt -+| eltcnt 
END END 


Where: 


regl 
specifies the vector register whose contents are to be displayed. reg] may be 
either a decimal number from 0 to 15 or a hexadecimal number from 0 to F. 
Register 0 is the default. | 


- or: 
indicates that a range of vector registers is to be displayed. 


reg2 
represents the last vector register whose contents are to be displayed. reg2 may 
be either a decimal number from 0 to 15 or a hexadecimal number from 0 to E. 
reg2 must be equal to or greater than reg/. 


END 
is the default value for reg2. If you select END, or if it serves as the default, the 
contents of all registers from the register specified by reg] to register 15 are 
displayed. 


indicates you want a count of registers to be displayed. 


regcnt 
specifies the number of vector registers whose contents are to be displayed. 
regcnt may be either a decimal number from | to 16 or a hexadecimal number 
from 1 to F. The range indicated by reg/ and regcnt cannot exceed register 15. 
END ee | 
is the default value for regcnt. If you select END, or if it serves as the default, 
the contents of all registers from the register specified by reg/ to register 15 are 
displayed. | 


indicates that a register element specification follows. If you omit both the 
comma and element specification, the contents of elements 0-3 are displayed. 
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elt! 
represents the first or only element to be displayed. e/t/ is a hexadecimal 
number from 0 to one less than the section size. 


- or: 
indicates that a range of vector elements is to be displayed. 


elt2 
represents the last element of a register whose contents are to be displayed. e/t2 
is a hexadecimal number from 0 to one less than the section size. e/t2 must be 
equal to or greater that elt. 


END 
is the default value for e/t2. If you select END, or if it serves as the default, all 
vector elements from the element specified by e/t/ to the last element of the reg- 
ister designated are displayed. 


indicates you want a count of elements to be displayed. 


eltcnt 
indicates the number of elements whose contents are to be displayed. eltcnt isa 
hexadecimal number from | to the section size. The range indicated by e/t/ and 
eltcnt cannot exceed the maximum number of elements. 


END 
is the default value for e/tcnt. It calls for the display of the contents of all reg- 
ister elements from the element specified by elt/ to the last element of the reg- 
ister. 


CPU xx 
is the address of the processor for which the vector register information is to be 
displayed. xx is a hexadecimal number between 0 and 3F. If you do not specify 
an address, the requested information is displayed for the processor on which the 
dump was initiated. 


Usage Notes: 


1. When you specify ranges for vector registers or elements of a vector register, the 
command cannot contain embedded blanks. For example, the following register 
specifications are invalid: 


VR 1 - 13 
or 
VR 1-13, 3 - 100 
The following register specifications are valid: 
VR 1-13 
or 
VR 1-13,3-100 


2. You can use the dump viewing facility’s CPU subcommand to find the address 
of each processor contained in the dump. 
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Example: 


Figure 83 shows the screen output you would receive if you entered the VREG 
command. The subcommand entered 1s: 


vreg 0-4,1-c 


==>Dumpscan Release 2.0 <===> DumpName VMDUMPQ1 <===> DumpType VM <=== 
VECTOR REGISTER(S) FOR CPU 02 


VROO,001 
VROO,005 
VROO, 009 
VRO1,001 
YRO1,005 


| VRO1,009 


VRO2,001 
VRO2,005 
VRO2 ,009 
VRO3,001 
YRO3,005 
VRO3 ,009 
VRO4,001 
VRO4,005 
VRO4 ,009 


===> 


10016D25 
00056025 
00096D25 
10016D25 
10056D25 
10096D25 
20016025 
20056D25 
20096D25 
30016D25 
30056D25 
30096025 
40016025 
40056D25 
40096D25 


00026D25 
00066D25 
000A6D25 
10026D25 
10066025 
100A6D25 
20026025 
20066D25 
200A6D25 
30026D25 
30066025 
300A6D25 
40026D25 
40066025 
400A6D25 


00036D25 
00076D25 
000B6D25 
10036D25 
10076025 
100B6D25 
20036D25 
20076D25 
200B6D25 
30036D25 
30076D25 
300B6D25 
40036D25 
40076025 
400B6D25 


00046D25 


00086D25 — 


000C6D25 
10046D25 
10086D25 
100C6D25 
20046D25 
20086D25 
200C6D25 
30046D25 
30086D25 
300C6D25 
40046D25 
40086D25 
400C6D25 


Figure 83. Sample Output from a VREG Subcommand 
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VSTAT Subcommand 
Use the VSTAT subcommand of DUMPSCAN to learn status information about 
the Vector Facility for any processor ina VM dump. Should no Vector Facility be 
available for the virtual machine or the processor requested, you receive an informa- 
tional message. 


VStat | CPU xx | 


Where: 


CPU xx 
specifies the processor address for which you want to have vector status informa- 
tion displayed. The processor address (xx) may be a hexadecimal number 
between 0 and 3F. If you do not specify the processor number, the vector status 
( .. is displayed for the processor on which the dump was initiated. 


Usage Note: 


You can use the CPU subcommand of DUMPSCAN to obtain the address of each 
processor in the dump. 


Example: 


-_ Figure 84 shows the screen output you would receive if you entered the VSTAT 
( | command. The subcommand entered is: 


vstat cpu 1 


==>Dumpscan Release 2.0 <===> DumpName VMDUMPQ1 <===> DumpType VM <=== 
VECTOR STATUS FOR CPU 01 


VAC = 90000000 261DC000 


( VMR = 99000000 99000000 69000000 e0B00000 
VSR = 00000080 OQOOFFFF 
VECTOR MODE 
VECTOR COUNT 
VECTOR INDEX 
VECTOR IN-USE 
VECTOR CHANGE 


SECTION SIZE = 080 


====> 


Figure 84. Sample Output from a VSTAT Subcommand 
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XEDIT Subcommand 


Use the XEDIT subcommand to force the dump viewing facility to pass the f 
commandline to XEDIT for execution. Mee 2 
The format of the CMS subcommand is as follows: 
| commandline | 
Where: 
commandline | 
is any valid XEDIT subcommand or macro and its operands. 

Usage Note: 

. oo“ 
Any XEDIT subcommand should be prefaced with XEDIT to prevent the dump 
viewing facility from processing the subcommand. 

a \ 
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Chapter 5. Messages and Message Summaries 


This chapter contains all of the messages that the dump viewing facility will issue. 
This chapter is organized as follows: 


e Message format 
e Message explanations 


e Message summary by message number. 


Dump Viewing Facility Message Format 


A dump viewing facility message contains a message identifier and message text. 
The message identifier uniquely identifies each message. The message text states an 
error or condition that has occurred, or it may request a user response. The format 
for dump viewing facility messages appears below. 


Message Identifier Message Text 


goer means, 


HCSmmmnnnt 
See a 


type indicator 
message number 


module 


component code 


Figure 85. Message Format for Dump Viewing Facility Messages 


The characters within the message identifier indicate the following: 


HCS The component code for all messages issued in the dump viewing facility. 
mmm The name of the module that issued the message. 

nnn The three-digit message number. 

t The letter code designating the type of message. 


It may be one of three letters — A, E, or I. 
e A—the user should take immediate action, which may be simply 
responding to a prompt. 
¢ :—an error has occurred. 
e j-the message is informational only. 
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How Messages Are Displayed 


Messages can be displayed in three ways, depending on how you issue the CP 
command SET EMSG. The choices and their results are: 
Command Display 
SET EMSG TEXT Message text 
SET EMSG CODE HCSmmmnonnt 
SET EMSG ON HCSmmmnnnt message text 
Note: For a more detailed description of the SET EMSG command, refer to the 
VM/XA SP: CP Command Reference manual. 

The dump viewing facility messages are listed numerically. The message description 
includes: 
Message number A unique three-digit number and type indi- 

cator for each message. —_ 
Message text A short sentence that describes a condition 

that has occurred or requests a response 

from the user. 
System action The action of the system after the condition 

was detected. 
User response _ The action the user takes after receiving a 

message. 
Commands that detect condition A list of commands and subcommands that | 

detect an error condition. Se 
The dump viewing facility messages are described with the following conventions: 
Lowercase letters These letters represent variables the system will replace with 

specific values when the message Is displayed. 
testy Within the braces, a bar separates the choices the system 
must make to complete the information in the message text. 
\ 


he esdat 
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Dump Viewing Facility Messages 


010A ENTER TRACE ENTRY SELECTION CRITERIA, NULL LINE TO END 
SELECTION, OR QUIT TO END TRACERED COMMAND 


Explanation: You are being prompted for trace selection criteria to be used in 
TRACERED command processing. If you enter a null line, no selection criteria 
are applied. As a result, everything will be traced. 


If you enter selection criteria, you will continue to receive this prompt until you 
enter a null line, thus indicating that entry of selection criteria is complete. 


For TRSOURCE-created data, the only applicable selection criteria is time. 
Prompting continues until you enter a valid time value, a null line, or QUIT. 


System Action: The system waits for a response to the prompt. 
User Response: Respond to the prompt with one of the following replies: 


( 1. Any combination of the following selection type keywords and values: 


CODE xxxx xxxx... 

You may enter up to 16 four-digit hexadecimal values representing the 
trace codes to be selected during data reduction of the input tape or 
system trace file. See the VM/XA SP: CP Command Reference for a list 
of valid trace codes. 


Note: Leading zeros (0) are required. 


ee The last two digits of any code may be specified as the character string ** 
( or *. This indicates that you want a range of trace codes. For instance, 
15** would select all trace entries beginning with the hexadecimal digits 
15. CODE 1s valid only for CPTRACE data. 


VMDBK xxxxxxxx XXXXxxxx... 

You may enter up to 16 hexadecimal values that represent the VMDBK 
addresses to be used during data reduction of the input tape or system 
trace file. Leading zeros are not required. Each address specified must 
be in the range of hex 0 to 7FFFF000 and on a page (4K-byte) boundary. 


( | RDEV xXxxx xxxx... 

his, 9 You may specify up to 16 hexadecimal values that represent the RDEV 
numbers to be used during data reduction of the input tape or system 
trace file. Leading zeros are not required. Each device number specified 
must be in the range of hex 0 to FFFF. RDEV ts valid only for 
CPTRACE data. 


VDEV xxxx xxxx... 

You may specify up to 16 hexadecimal values that represent the VDEV 
numbers to be used during data reduction of the input tape or system 
trace file. Leading zeros are not required. Each device number specified 
must be in the range of hex 0 to FFFF. VDEV 1s valid only for 
CPTRACE data. 
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CPU xxxx xxxx... 

You may specify up to 16 hexadecimal values that represent the processor : 

addresses to be used during data reduction of the input tape or system ‘a 

trace file. Leading zeros are not required. Each processor address speci- = 
fied must be in the range of hex 0 to 3F. CPU is valid only for 

CPTRACE data. 


TIME mm/dd/yy hh:mm:ss mm/dd/yy hh:mm:ss 

You may designate a start and stop date/time for the data reduction of 
the trace entries. If this option is selected, only trace entries created 
within the designated time range will be processed. You may select only 
one time range. All TIME parameters can be entered on the same line. 
TIME 1s valid for both guest trace and CP entries. 


CMS - To enter the CMS subset mode. 
HELP - To invoke the help panel for the TRACERED command. 
QUIT - To terminate the TRACERED command. 


— a oe 


A null line - To indicate that you are done entering selection criteria and want 
to end prompting. 


If your immediate reply to the prompt is a null line, then all trace entries are 
selected. 


See page 48 for usage notes for entering selection criteria. 
Commands That Detect Condition: 
TRACERED 


015A WILL YOU BE MOUNTING ANOTHER TRSAVE TAPE? ENTER YES OR Steg 
NO 


Explanation: TRACERED encountered the end-of-volume on the current trace 
input tape. If you enter “yes,” TRACERED will rewind and unload the current 
tape and wait for the next tape mount. If you enter “no,” TRACERED will com- 
plete processing. | 


System Action: The system waits for a reply to the prompt. 


User Response: Reply “yes” if you want additional trace data to be processed. 
Reply “no” if you do not. 


Commands That Detect Condition: 
TRACERED 


020E ‘operandl’ AND ‘operand2’ ARE CONFLICTING KEYWORD OPERANDS 


Explanation: You entered conflicting operands (designated by “operand1” and 
“operand2” in the error message) in the TRACERED command. 


System Action: The TRACERED command terminates. 


User Response: Specify operands that do not conflict and reenter the TRAC- 
ERED command. | 


Commands That Detect Condition: co 
TRACERED 3 
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O21E 


0301 


0311 


Messages 


TAPE DEVICE ADDRESS INVALID 


Explanation: The tape device address you entered in the TRACERED command 
is invalid. Only virtual tape addresses 181 through 184 are supported. 


System Action: The TRACERED command terminates. 


User Response: Reenter the TRACERED command specifying a tape device 
within the 181-184 range. 


Commands That Detect Condition: 
TRACERED 


PROCESSING TRSAVE TAPE - VOL SEQ # on - CREATED mm/dd/yy 
hh:mm:ss 


Explanation: This informational message indicates the TRACERED command 
has successfully read the volume label of the current TRSAVE input trace tape. 
The volume sequence number (“nn” in the message) and date the tape was created 
(“mm/dd/yy”) are identified. 


System Action: TRACERED processes trace entries from the specified tape until 
encountering the end-of-volume. 


User Response: A message, 015A (see page 162), appears when end-of-volume is 
reached. You have the options of either ending processing or continuing with 
additional tape volumes. 


Commands That Detect Condition: 
TRACERED 


END OF TAPE ENCOUNTERED 


Explanation: TRACERED has encountered the end-of-volume condition on the 
current input tape. 


System Action: The input tape is rewound. 
User Response: None 
Commands That Detect Condition: 

TRACERED 
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Messages 


0321 


040E 


041E 
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WAITING FOR TAPE MOUNT 


Explanation: You replied “yes” to prompt message 015A which asked you if you a 


wanted a new TRSAVE tape to be mounted. As a result, TRACERED is waiting ee 


for the tape to be mounted. 


System Action: Once the input tape is mounted, TRACERED will begin proc- 
essing it. 


User Response: Instruct the operator to mount the desired TRSAVE tape. 


Commands That Detect Condition: 
TRACERED 


TIME SELECTION RANGE MAY BE SPECIFIED ONLY ONCE 


Explanation: You entered more than one time selection range in response to the 
prompt for trace selection criteria. Although you may specify selection criteria on 
many different lines in response to the prompt, you may specify only one time 


selection range for all the selection replies combined for one TRACERED Rete / 


command. 


System Action: All of the selection criteria you entered in response to previous 
prompts remain in effect. The selection criteria you specified in the most recent 
response are ignored. You will be reprompted for additional trace selection cri- 
teria. — 


User Response: If you wish to enter additional values for trace selection criteria, 
do so when prompted. Or, if you wish to end the selection process, enter a null 
line. You may stop TRACERED processing altogether by entering QUIT. 


Commands That Detect Condition: 
TRACERED 


A MAXIMUM OF SIXTEEN CPU ADDRESSES MAY BE SPECIFIED 
Explanation: 


1. You entered more than 16 CPU address values in response to the prompt(s) 
for trace selection criteria. Although you may specify selection criteria on \ 
many different lines in response to the prompt(s), the total number of CPU 
addresses in all of your responses must not exceed 16 for one TRACERED 
command. 


2. You entered more than 16 CPU address values under the SELECT subcom- 

~ mand of DUMPSCAN. Although you may specify selection criteria on many 
different invocations of SELECT, the total number of CPU address values in 
all of your requests must not exceed 16 for one invocation of the TRACE 
subcommand of DUMPSCAN. 


System Action: 


1. All of the selection criteria you entered in response to previous prompts 


remain in effect. The selection criteria you specified in the most recent 
response are ignored. You will be se ac for additional trace selection 
criteria on the TRACERED command. 


2. All of the selection criteria you entered previously remain in effect. The 
selection criteria you specified in the most recent response are ignored. 


Messages 


User Response: 


( 1. When reprompted for additional trace selection criteria, enter the additional 
a” values. Or, if you want to end the selection process, enter a null line. 


2. You may reenter other selection criteria or another subcommand or quit 
DUMPSCAN processing. 


Commands That Detect Condition: 


1. TRACERED 
2. SELECT subcommand of DUMPSCAN 


042E A MAXIMUM OF SIXTEEN TRACE CODES MAY BE SPECIFIED 
Explanation: 


1. You entered more than 16 trace code values in response to the prompt(s) for 
eres trace selection criteria. Although you may specify selection criteria on many 
( different lines in response to the prompt(s), the total number of trace code 
values in all of your responses must not exceed 16 for one TRACERED 
command. 


2. You entered more than 16 trace code values under the SELECT subcommand 
of DUMPSCAN. Although you may specify selection criteria on many dif- 
ferent invocations of SELECT, the total number of trace code values in all 
your requests must not exceed 16 for one invocation of the TRACE subcom- 
mand of DUMPSCAN. 


( - System Action: 
= | 1. All of the selection criteria you entered in response to previous prompts 
remain in effect. The selection criteria you specified in the most recent 


response is ignored. You will be reprompted for additional trace selection 
criteria. 


2. All the selection criteria you entered previously remain in effect. The 
selection criteria you specified in the most recent request is ignored. 


User Response: 


( 1. When reprompted for additional trace selection criteria, enter the additional 
- values. Or, if you want to end the selection process, enter a null line. 


2. You may reenter other selection criteria on the SELECT subcommand of 
DUMPSCAN, or another subcommand, or you may quit DUMPSCAN proc- 
essing. 


Commands That Detect Condition: 


1. TRACERED 
2. SELECT subcommand of DUMPSCAN 
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Messages 


043E _ A MAXIMUM OF SIXTEEN VMDBK ADDRESSES MAY BE SPECIFIED 
Explanation: & as 
1. You entered more than 16 VMDBK address values in response to the ee 
prompts for trace selection criteria on the TRACERED command. Although 
you may specify selection criteria on many different lines in response to the 
prompts, the total number of VMDBK address values in all of your responses 
must not exceed 16 for one TRACERED command. 
2. You entered more than 16 VMDBK address values under the SELECT sub- 
command of DUMPSCAN. Although you may specify selection criteria on 
many different invocations of SELECT, the total number of VMDBK address — 
values in all of your requests must not exceed 16 for one invocation of the 
TRACE subcommand of DUMPSCAN. 
System Action: 
1. All of the selection criteria you entered in response to previous prompts 
remain in effect. The selection criteria you specified in the most recent a 
response is ignored. You will be reprompted on the TRACERED command : 
for additional trace selection criteria. A 
2. All the selection criteria you entered previously remain in effect. The 
selection criteria you specified in the most recent request is ignored. 
User Response: 
1. When reprompted for additional trace selection criteria on the TRACERED 
command, enter the additional values. Or, if you wish to end the selection 
process, enter a null line. eee 
2. You may reenter selection criteria or another subcommand, or you can quit . yg 
DUMPSCAN processing. 7 
Commands That Detect Condition: 
1. TRACERED 
2. SELECT subcommand of DUMPSCAN 
2 
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Messages 


044E A MAXIMUM OF SIXTEEN RDEV NUMBERS MAY BE SPECIFIED 


Explanation: 


1. You entered more than 16 RDEV values in response to the prompts for trace 
selection criteria. Although you may specify selection criteria on many dif- 
ferent lines in response to the prompts, the total number of RDEV values in 
all of your responses must not exceed 16 for one TRACERED command 


2. You entered more than 16 RDEV values under the SELECT subcommand of 
DUMPSCAN. Although you may specify selection criteria on many different 
invocations of SELECT, the total number of RDEV values in all of your 
requests must not exceed 16 for one invocation of the TRACE subcommand 
of DUMPSCAN. 


System Action: 


1. All of the selection criteria you entered in response to previous prompts 
remain in effect. The selection criteria you specified in the most recent 
response are ignored. You will be reprompted for additional trace selection 


( critera. 


2. All of the selection criteria you entered previously remain in effect. The 
selection criteria you specified in the most recent request is ignored. 


User Response: 


1. When reprompted for additional trace selection criteria, enter the additional 
values. Or, if you want to end the selection process, enter a null line. 


2. You can reenter other selection criteria or another subcommand, or you can 
( quit DUMPSCAN processing. 


Commands That Detect Condition: 


1. TRACERED 
2. SELECT subcommand of DUMPSCAN 


045E A MAXIMUM OF SIXTEEN VDEV NUMBERS MAY BE SPECIFIED 
( - Explanation: 


1. You entered more than 16 VDEV values in response to the prompts for trace 
selection criteria. Although you may specify selection criteria on many dif- 
ferent lines in response to the prompt, the total number of VDEV values in 
all of your responses must not exceed 16 for one TRACERED command. 


2. You entered more than 16 VDEV values under the SELECT subcommand of 
DUMPSCAN. Although you may specify selection criteria on many different 
invocations of SELECT, the total number of VDEV values in all your 
requests must not exceed 16 for one invocation of the TRACE subcommand 
of DUMPSCAN. 


System Action: 


1. All of the selection criteria you entered in response to previous prompts 
remain in effect. The selection criteria you specified in the most recent 
response are ignored. You will be reprompted for additional trace selection 
criteria. 


to 


. All of the selection criteria you entered previously remain in effect. The 
selection criteria you specified in the most recent request is ignored. 
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Messages 


User Response: 


1. When reprompted for additional trace selection criteria, enter the additional £~ 
values. Or, if you want to end the selection process, enter a null line. 


2. You can reenter other selection criteria or another subcommand or you can 
quit DUMPSCAN processing. 


Commands That Detect Condition: 


1. TRACERED 
2. SELECT subcommand of DUMPSCAN 


046E A MAXIMUM OF SIXTEEN USERIDS MAY BE SPECIFIED 


Explanation: You entered more than 16 USERID values under the SELECT sub- 

command of DUMPSCAN. Although you may specify selection criteria on many 

different uses of the SELECT subcommand, the total number of USERID values 
in all your requests must not exceed 16 for one invocation of the TRACE sub- a 
command of DUMPSCAN. ee 


System Action: All of the selection criteria you entered in response to previous 
prompts remain in effect. The selection criteria you specified in the most recent 
response are ignored. 


User Response: You can enter other selection criteria or another subcommand, or 
you can quit DUMPSCAN processing. 


Commands That Detect Condition: - 
SELECT subcommand of DUMPSCAN ‘ \ 


f : 
M 


049E LEADING ZEROS REQUIRED FOR CODE SELECTION VALUE ‘value’ 
Explanation: 


1. You entered a CODE value without leading zeros in response to the prompt 
for trace selection criteria on the TRACERED command. A 4-digit trace 
selection code with leading zeros is expected as a CODE value when you are 
prompted for selection criteria. oe 


2. You entered a CODE value without leading zeros as an operand on the Se 
SELECT subcommand of DUMPSCAN. A 4-digit trace selection code with 
leading zeros is expected as a CODE value on the SELECT subcommand of 
DUMPSCAN. 


System Action: 


1. All of the selection criteria you entered in response to previous prompts, 
remain in effect. The selection criteria you specified in the most recent 
response is ignored. You will be reprompted for additional trace selection cri- 
teria. 


2. All of the selection criteria you entered previously, remain in effect. The 
selection criteria you specified in this request is ignored. 
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OS0E 


Messages 


User Response: 


1. When reprompted for additional trace selection criteria, reenter the trace 
CODE value with leading zeros or, if you wish to end the selection process, 
enter a null line. 


See message 010A for an explanation of trace CODE selection values that are 
valid. 


2. Reenter the SELECT subcommand of DUMPSCAN specifying the trace 
CODE value with leading zeros. See the SELECT subcommand section of 
this manual for an explanation of the trace CODE selection values that are 
valid. 


Commands That Detect Condition: 


1. TRACERED 
2. SELECT subcommand of DUMPSCAN 


‘value’ IS NOT A VALID SELECTION VALUE 
Explanation: 


1. You entered an invalid value on the prompt for trace selection criteria and 
the invalid value is specified in the message. 


2. You entered an invalid value on the SELECT subcommand of DUMPSCAN. 
That value is specified in the message. 


System Action: 


1. All of the selection criteria you entered in response to previous prompts 
remain in effect. The selection criteria you specified in the most recent 
response are ignored. You will be reprompted for additional trace selection 
criteria on the TRACERED command. 


2. All of the selection criteria you entered previously remain in effect. The 
selection criteria you specified in the most recent request 1s ignored. 


User Response: 


1. When reprompted for additional trace selection criteria on the TRACERED 
command, enter the additional values. Or, if you want to end the selection 
process, enter a null line. 


See message 010A (page 161) or the TRACERED command section (page 48) 
of this manual for an explanation of the trace selection values that are valid. 


2. Reenter the SELECT subcommand of DUMPSCAN with new criteria. See 
the SELECT subcommand section of this manual for an explanation of trace 
selection values that are valid. 


Commands That Detect Condition: 


1. TRACERED 
2. SELECT subcommand of DUMPSCAN 
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Messages 


OS1E 


052E 


060K 


061E 


THE keyword OPERAND ‘value’? WAS NOT PREVIOUSLY SELECTED 


_ Explanation: The value specified in the message is an invalid RESET value. You 


did not previously select that value and, therefore, you cannot RESET it. 


System Action: All of the selection criteria you entered previously remain in 
effect. The SELECT RESET criteria you specified in the most recent request are 
ignored. 


User Response: Reenter the SELECT subcommand of DUMPSCAN with the 
QUERY keyword. Verify the selection criteria you want to reset to a new value. 
Enter the SELECT RESET request with the correct data or enter another 
DUMPSCAN subcommand or quit. 


Commands That Detect Condition: 
SELECT subcommand of DUMPSCAN 


CP SELECTION KEYWORD(S) SPECIFIED FOR GUEST TRACE TABLES - 
KEYWORD(S) IGNORED 


Explanation: The selection keyword you specified is not valid for guest trace 
tables. 


System Action: Any CP selection keywords are ignored. You will be reprompted 
for a valid keyword. 


User Response: Enter a valid selection keyword for guest trace table entries. 
TIME is the only valid selection. Or enter a null line to end the prompt. 


Commands That Detect Condition: 
TRACERED 


TAPE WAS NOT CREATED BY THE TRSAVE COMMAND 


Explanation: The input tape does not contain a valid volume label created by the 
TRSAVE command. 


System Action: The input tape is rewound. The system then allows you to 
mount another tape. 


User Response: If you want additional trace data to be processed, make sure that 
the input tape you mounted was created by the TRSAVE command. 


Commands That Detect Condition: 
TRACERED 


TAPE vdev IS NOT ATTACHED 


Explanation: The virtual tape device specified by the variable “vdev” in this 
message 1s not attached to your virtual machine. 


System Action: The TRACERED command terminates. 


User Response: Attach a real tape device to your virtual machine as indicated by 
the virtual device address variable. Then make sure the desired TRSAVE input 
tape is mounted. Reenter the TRACERED command. 


Commands That Detect Condition: 
TRACERED | 
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EN 


\ 


062E 


0701 


0711 


Messages 


PERMANENT TAPE I/O ERROR 


Explanation: A permanent I/O error occurred while the TRSAVE input tape was 
being read. 


System Action: The TRACERED command terminates. 


User Response: Ask the operator to take corrective action to avoid the I/O error. 
Reenter the TRACERED command. If the problem persists, contact IBM service 
personnel. 


Commands That Detect Condition: 
TRACERED 


NO TRACE ENTRIES FOUND MEETING THE REQUESTED SELECTION 
CRITERIA 


Explanation: Although the TRACERED command or the TRACE subcommand 
of DUMPSCAN successfully processed the current TRSAVE input tape or trace 
table(s) in the dump file, no trace entries met the selection criteria you specified. 


System Action: For TRACERED, the system allows you to have another 
TRSAVE input tape mounted or to end TRACERED command processing. Sub- 
command processing continues for the TRACE subcommand of DUMPSCAN. 
You can enter another subcommand or quit DUMPSCAN processing. 


User Response: If you are using the TRACERED command, check the selection 
criteria you specified in response to the 010A prompt. For both TRACERED or 
the TRACE subcommand of DUMPSCAN, if you expected trace entries meeting 
the selection criteria to be found, make sure you correctly typed in all the data 
reduction values. 


If you did correctly type in the values for TRACERED, reenter that command. 
Specify a different set of selection criteria when you respond to the 010A prompt 
on TRACERED. Or, mount a tape created in another time interval and issue the 
TRACERED command with the same selection criteria. 


If you are using the TRACE subcommand of DUMPSCAN, check the selection 
criteria you specified with the SELECT subcommand. If you expected trace 
entries that meet the selection criteria you find, be sure you correctly typed in all 
the data reduction values. If you correctly entered those values, reenter the 
SELECT subcommand and specify a different set of selection criteria. Then enter 
the TRACE subcommand again. 


Commands That Detect Condition: 


TRACERED 
TRACE subcommand of DUMPSCAN 


ONE OR MORE TRACE ENTRIES MISSING FROM TRSAVE 
TAPE(S)--VOL SEQ # nn 


Explanation: When one or more TRSAVE input tapes were processed, certain 
records were encountered that indicated trace entries are missing. Missing trace 
entries can result when the TRSAVE input tapes are being created. The trace 
table wraps faster than CP can write the entries to the output device. This situ- 
ation is recorded in a formatted form in the TRACERED print or CMS output 
files. The CPU address from which trace data was lost is recorded. Normal proc- 
essing continues with the next available trace entry from that processor. 
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Messages 


074E 


076E 


080E 


System Action: The TRACERED command has successfully completed and the 
system waits for a new command. 


User Response: Examine the TRACERED output by checking the TRACERED 
print or CMS output files. All records identifying lost data are preceded and fol- 
lowed by a blank line. 


Commands That Detect Condition: 
TRACERED 


THE SYSTEM TRACE FILE NAME ‘filename’ WAS NOT FOUND 


Explanation: You specified a system trace filename as input to the TRACERED 
command and that file was not found. 


System Action: Command processing is terminated. — 


User Response: You can verify the name of the referenced system trace file by 
using the QUERY TRFILES command. 


Commands That Detect Condition: 
TRACERED 


THE OPERAND GTRACE IS NOT VALID FOR CP TRACE DATA 


Explanation: You requested that TRACERED produce an output file in OS 
QSAM format containing GTRACE records, but you specified an input file con- 
taining CP trace table data rather than guest trace data recorded by GCS. 


System Action: TRACERED command processing is rejected. 


User Response: Use the TRACERED command again specifying the correct 
input file. Use the QUERY TRFILES command to determine the spoolid of the 
system trace file containing the GCS GTRACE records you want to process. 


Commands That Detect Condition: 
TRACERED 


DUPLICATE INPUT SYSTEM TRACE FILES WERE SPECIFIED 


Explanation: You entered two identical filenames or spoolids, or you entered a 
spoolid and then a filename, but the spoolid was within a set designated by the 
filename. 


System Action: Command processing is terminated. 
User Response: Reenter the TRACERED command with correct input. 


Commands That Detect Condition: 
TRACERED 
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081E 


082E 


0831 


0841 


__ Messages 


SYSTEM TRACE FILE spoolid IS INVALID 


Explanation: You entered an invalid system trace file spoolid on the TRAC- 
ERED command line. The parameter must be a decimal number from | to 9999 
for the spoolid. 


System Action: Command processing is terminated. 


User Response: Use the QUERY TRFILES command to find the associated 
filename and then you can ascertain valid spoolids. 


Commands That Detect Condition: 
TRACERED 


ERROR { OPENING|READING|CLOSING} SYSTEM TRACE FILE spoolid, 
CODE nn 


Explanation: TRACERED received an error during an open, read, or close of a 
system trace file. 


System Action: Command processing 1s terminated. 


User Response: See VM/XA SP CP Command Reference for an explanation of 
the code for DIAGNOSE X'E0'. 


Commands That Detect Condition: 
TRACERED 


PROCESSING SYSTEM TRACE FILES spoolid CREATED mm/dd hh:mm:ss 
Explanation: The file designated by spoolid is being processed. 


System Action: TRACERED will process trace entries from the specified system 
file. 


User Response: None 
Commands That Detect Condition: 
TRACERED 


PROCESSING COMPLETE - nnannonon TRACE ENTRIES FORMATTED 


Explanation: The TRACERED command has finished processing. The total 
number of trace entries processed by the TRACERED command is specified by 
“nnnnnnnn”. 


System Action: Command processing has completed normally. 
User Response: None 
Commands That Detect Condition: 

TRACERED 


Chapter 5. Messages and Message Summaries 173 


Messages 


O85E 


086E 


088E 


089K 


SYSTEM TRACE FILENAME ‘filename’ HAS FILES FROM MORE THAN 
ONE ORIGINATOR. RE-ENTER COMMAND AND SPECIFY FILENAME 


WITH SPOOLID 


Explanation: The filename entered was created by two different originators. 
System Action: Command processing is terminated. 


User Response: Issue the QUERY TRFILES command to find the starting 
spoolid for the filename belonging to the originator you want. Reenter the 
TRACERED command in a form with the originator’s name, the filename, and id 
where id is the beginning spoolid for the originator’s filename. 


Commands That Detect Condition: 
TRACERED 


SYSTEM TRACE FILE spoolid IS CURRENTLY IN USE 


Explanation: TRACERED attempted a DIAGNOSE X'E0' OPEN and failed . 
on the specific system trace file because it was in use. 


System Action; Command processing is terminated. 


User Response: Enter QUERY TRSAVE to determine if tracing 1s still active and 
if the specific system trace file you requested is still in use. If it is and you want 
to process immediately, you must turn TRSAVE OFF for the user. After proc- 
essing, you can turn it on for the user with a different filename, then reenter the 
TRACERED command for that user. 


Commands That Detect Condition: 
TRACERED 


THE SYSTEM TRACE FILE SPOOLID ‘spoolid? WAS NOT FOUND 


Explanation: You issued TRACERED with a specific system trace file spoolid as 
input and that file was not found. 


System Action: Command processing is terminated. 


User Response: Use the QUERY TRFILES command to verify the spoolid of 
the referenced system trace file. 


Commands That Detect Condition: 
TRACERED 


ONLY ONE CP TAPE OR CP SYSTEM TRACE FILE IS ALLOWED 


Explanation: A total of five system trace files can be merged. However, only one 
CP system trace file or tape can be included. You need to specify one of the 
following: 


e One CP system trace file with up to four TRSOURCE system trace files 
¢ One CP tape with up to four TRSOURCE system trace files 
¢ Up to five TRSOURCE system trace files. 


System Action: Command processing is terminated. 


User Response: Reenter the TRACERED command and specify only one CP 
tape or file. 
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a 


090E 


091! 


0921 


Messages 


Commands That Detect Condition: 
TRACERED 


DUPLICATE KEYWORDS WERE SPECIFIED 
Explanation: You entered a duplicate keyword in the TRACERED command, or 


the TIME selection keyword was entered twice. 


System Action: Processing ends if a duplicate keyword was specified on the 
TRACERED command line, but processing continues for selection criteria. 
Current time parameters are ignored. 


User Response: Reenter the TRACERED command and omit the duplicate 
keyword, or continue entering selection criteria. 


Commands That Detect Condition: 
TRACERED 


ONE OR MORE TRACE ENTRIES MISSING FROM SYSTEM TRACE 
FILE(S) FOR spoolid 


Explanation: During the processing of system trace files, records were found to 
indicate missing trace entries. Missing entries result if trace table entries wrap 
faster than CP can write the entries to an output device or file. The wrapping 
situation is recorded in TRACERED print or CMS output files with the CPU 
address from which the data was lost. Normal processing continues with the next 
available trace entry from that processor. 


System Action: Command processing continues. 


User Response: Examine the TRACERED output by checking the TRACERED 
print or CMS output files. All records identifying lost data will be preceded and 
followed by a blank line. 


Commands That Detect Condition: 
TRACERED 


TIME ZONES ARE DIFFERENT FOR SPOOLID spoolid. FILE IS NOT 
PROCESSED 


Explanation: The files you want to merge were created in different time zones. 
System Action: Command processing is terminated. 


User Response: Reenter the TRACERED command with files from the same 
time zone. 


Commands That Detect Condition: 
TRACERED 
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(0931 


094K 


095E 


096E 
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TIME ZONES ARE DIFFERENT FOR TAPE - VOL SEQ# on. FILE IS NOT 
PROCESSED. 


ee You cannot merge a tape and file that were created in different \ 
time zones. 


System Action: Command processing is terminated. 


User Response: Reenter the TRACERED command with files from the same 
time zone. 


Commands That Detect Condition: 
TRACERED 


THE STARTING DATE AND TIME MUST BE LESS THAN THE ENDING 
DATE AND TIME 


Explanation: You specified a starting date or time that is greater than the ending 
date or time as a selection criteria. ite 


System Action: TRACERED will prompt you for new selection criteria. KY 


User Response: Reenter the TIME keyword and a starting date that is earlier 
than the ending date, or a null line to end the prompt. 


Commands That Detect Condition: 
TRACERED 


THE SYSTEM TRACE FILE SPOOLID ‘spoolid? WAS NOT FOUND WITHIN oN 
FILENAME ‘filename’ 


Explanation: You issued the TRACERED command in the form “NAME fn, 
id”. The id which represents a spoolid is not associated with the filename. 


System Action: Command processing is terminated. 


User Response: Use the QUERY TRFILES command to verify the spoolid of 
the referenced system trace file. 


Commands That Detect Condition: . 
TRACERED 


RE-IPL CMS. TRACERED HAD A SEVERE ERROR 

Explanation: There was an I/O error writing to a file. 

System Action: Command processing is terminated. 

User Response: Re-IPL CMS and reenter the TRACERED command. 


Commands That Detect Condition: 
TRACERED 


110E 


120A 


121A 


Messages 


THE FILE NAME ‘filename’ IS NOT VALID 


Explanation: If in ADDMAP, DUMPSCAN, or PRTDUMP mode, the dump 
file name entered is not valid. If in MAP mode, the file name entered is not 
valid. Acceptable file names are the file names for a CMS file: a 1- to 8-character 
string with the characters 0-9, A-Z, #, @, +,-, _,:, and $. 


System Action: If in ADDMAP, DUMPSCAN, or PRTDUMP mode, the 
message 120A will be issued to prompt you for the correct name of the CMS file 
containing the dump. If in MAP mode, either message 121A or 122A will be 
issued to prompt you for the correct name of the CMS file containing either the 
load map or the module map. 


User Response: If in ADDMAP, DUMPSCAN, or PRTDUMP mode, enter the 
correct dump file name. If in MAP mode, enter either the correct load map or 
module map name. 


Commands That Detect Condition: 


ADDMAP 
DUMPSCAN 
PRTDUMP 
MAP 


ENTER DUMP FILE NAME IN THE FORM XXXXXXXX, OR IN THE 
FORM XXXXXXXX FILEMODE 


Explanation: A command was issued to process a specific dump file, and you are 
being asked to specify which file you wish to process. 


System Action: No further processing occurs until the user responds. 


User Response: You may specify a valid dump fileid to continue command proc- 
essing, or enter HX to terminate the command. 


Commands That Detect Condition: 


ADDMAP 
DUMPSCAN 
PRTDUMP 


ENTER THE FILENAME FILETYPE FILEMODE OF THE INPUT type 
LOAD MAP, A NULL LINE, SUBSET OR HX 


Explanation: You are being prompted for the filename, filetype, and filemode of 
a load map to be processed. If the file cannot be found, this prompt will be 
repeated. 


Where “type” is: 


CP NUCLEUS 

CMS NUCLEUS 

GCS NUCLEUS 

PVM (Primary CMS/PVM load map) 
RSCSNET 

RSCSV2 


System Action: The dump viewing facility waits for a response. 
User Response: Enter one of the following: 


1. “filename filetype filemode” 
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Messages 


If the filetype and filemode are not included, then MAP and * will be 


employed, respectively. € 
2. A null line -_ 
Requests use of the predefined filename: 
Type Input Map Names 
CP. CPLOAD MAP * 
CMS CMSNUC MAP * 
GCS GCSNUC MAP * 
PVM CMSNUC MAP * (primary) 
| PVM MAP * (secondary) 
RSCSNET RSCSNET MAP * | 
RSCSV2 RSCSV2 MAP * 
3. SUBSET 
Requests CMS subset mode. You should verify the name of the file you wish ore 
to process. You should also verify that you are currently accessing the CMS J 
disk on which the file resides. 
4. HX 
Terminates the MAP command. 
Commands That Detect Condition: 
MAP 
| | a ‘ 
122A ENTER THE FILENAME FILETYPE FILEMODE OF THE OUTPUT type ue 
MODULE MAP, A NULL LINE, SUBSET, OR HX 
Explanation: You are being prompted for the filename, filetype, and filemode 
that will contain the compressed input load maps. 
Where type is: 
CP 
CMS 
RSCSNET 
RSCSV2 


System Action: The dump viewing facility waits for a response. 
User Response: Enter one of the following: 
1. “filename filetype filemode” 


If the filetype and filemode are not included, then MAP and A will be 
employed, respectively. 


2. A null line 
Requests use of the predefined filename: 


Type . Output Map Names 


cP HCPXADVF MAP A 
CMS CMSDVF MAP A 
GCS GCSDVF MAP A 
PVM | PVMDVF MAP A 
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123A 


Messages 


RSCSNET RSCSDVF MAP A 
RSCSV2 RSV2DVF MAPA 
. SUBSET 


Requests CMS subset mode. You should verify the name of the file you wish 
to create. You should also verify that you are currently accessing the CMS 
disk on which the file will reside. 


. HX 


Terminates the MAP command. 


Commands That Detect Condition: 


MAP 


ENTER THE MAP TYPE, A NULL LINE, SUBSET, OR HEX 


Explanation: You entered the MAP PROmpt or MAP command. The dump 
viewing facility is requesting information on the type of map you want to process. 


System Action: The dump viewing facility waits for a response. 


User Response: Enter one of the following: 


1. 


CP 
Specifies that a CP load map is to be processed. 


. CMS 


Specifies that a CMS load map is to be processed. 


. PVM 


Specifies that VM/Pass-Through load maps are to be processed. 


. RSCSnet 


Specifies that an RSCSNET load map is to be processed. 


. GSC 


Specifies that a GCS load map is to be processed. 


. RSCSV2 


Specifies that an RSCSV2 load map is to be processed. 


. Null line 


Specifies that a CP load map is to be processed. 


. SUBSET 


Requests CMS subset mode. 


. HX 


Terminates the MAP command. 


Commands That Detect Condition: 


MAP 


Chapter 5. Messages and Message Summaries 179 


mY acters preene een Alienate Asenprlenisting GURY aS TIER Fs widieadly po PES ee Se eee 


Messages 


130E 


135E 


140E 


THE type FILE filename filetype filemode WAS NOT FOUND 


Explanation: A command was issued to process a specific CMS file, and that file 
was not found. 


System Action: Command processing is terminated, or you are prompted for the 
correct file name. 


User Response: You should verify the name of the file you wish to process. You 
should also verify that you are currently accessing the CMS disk on which the file 
resides. If prompted, enter the correct file name, or else reissue the command 
with the correct file name. , 


Commands That Detect Condition: 
Command Type 


ADDMAP MODULE MAP 
DUMPSCAN DUMP FILE 
MAP type maptype LOAD MAP 

PRTDUMP DUMP FILE 


Where: 


type maptype 
CP NUCLEUS 
CMS : NUCLEUS 
GCS NUCLEUS 
PVM - (Secondary PVM load map) 
RSCSNET - 
RSCSV2 - 


THE FILE filename filetype filemode ALREADY EXISTS 
Explanation: The output file specified on the command exists already. 


System Action: If you included the specified file identifier in the TRACERED or 
MAP command, the command terminates. If you entered the specified fileid as a 
response to a MAP prompt, you will be reprompted for another fileid. 


User Response: Check to see that you typed the fileid correctly. If you did not 
enter the fileid correctly, do so on either the TRACERED or MAP command line 
or in response to the MAP prompt. If you did enter the fileid correctly, try 
renaming the file and reentering the command or response. 


Commands That Detect Condition: 


MAP 
TRACERED 


THE FILE filename filetype filemode IS NOT A VALID type FILE 


Explanation: The specified file does not contain valid data for the specified type 
of file. For a load map, the file containing the map was not in the expected 
format. 


System Action: Command processing is terminated. 


User Response: Check to see if the fileid was typed incorrectly. Correct the input 
and reenter or enter a new command. 
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145E 


( . 1501 


2001 


Messages 


Commands That Detect Condition: 


Command Type 
MAP type 
Where: 


The type is one of the following: 


CP NUCLEUS LOAD MAP 
CMS NUCLEUS LOAD MAP 
GCS NUCLEUS LOAD MAP 
PVM LOAD MAP 

RSCSNET LOAD MAP 
RSCSV2 LOAD MAP 


THE DUMP FILE REQUESTED IS NOT A VALID DUMP 


Explanation: The specified dump file was not a valid CP or virtual machine 
dump. 


System Action: Command processing is terminated. 
User Response: Reenter the command with the correct file name. 
Commands That Detect Condition: 

DUMPSCAN 


THE type FILE filename filetype filemode IS INCOMPLETE 
Explanation: The requested file was incomplete. 


System Action: For MAP and ADDMAP, processing is terminated. For 
DUMPSCAN and PRTDUMP, processing continues. 


User Response: Generate a new load map. 


Commands That Detect Condition: 


Command Type 
ADDMAP DUMP 
DUMPSCAN DUMP 
MAP CP NUCLEUS LOAD MAP 


CMS NUCLEUS LOAD MAP 
GCS NUCLEUS LOAD MAP 
PVM LOAD MAP (PVM secondary load map) 
RSCSNET LOAD MAP 
RSCSV2 LOAD MAP 
PRTDUMP DUMP 


PROCESSING FILE filename DUMP filemode 
Explanation: The command has begun processing the CMS filename DUMP. 
System Action: Command processing continues. 


User Response: None. 
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Messages 


Commands That Detect Condition: 


DUMPSCAN 
PRTDUMP | — 


ne 


\ 
sy 


2101 THE SUMMARY REPORTS HAVE BEEN PRINTED FOR FILE filename 
DUMP filemode 


Explanation: The PRTDUMP command has finished processing the specified 
dump file. 


User Response: None. 


Commands That Detect Condition: 
PRTDUMP 


2201 THE type SUMMARY REPORT IS NOT COMPLETE; SEE REPORT FOR pre 
DETAILS | 


Explanation: An error was encountered in the PRTDUMP processing of the 
specified summary report, and it was not possible to print the entire summary 
report. 


System Action: The printing of other dump data will continue. 


User Response: Refer to the printed summary report for the detailed reasons why 
the summary report was not complete. 


Commands That Detect Condition: | aa 
Command Type 


PRTDUMP FRMTB 
FRAMETBL 
MAP 
PROCESSOR 
RIOBLOK 
SYMPTOM 
TRACE 
USER es 
VMDBK ae 
‘DUMPID 


230A DO YOU WANT PRINTING TO CONTINUE? ENTER YES OR NO 


Explanation: A condition has been detected that might cause you not to want the 
dump summary reports printed. This message is preceded by another message, 
which explains the condition. You have the choice of whether or not to continue 
printing the dump summary reports. 


System Action: If you enter an invalid response, the prompt is reissued. If you 
respond YES, command processing continues. If you respond NO, command 
processing is terminated. 


User Response: You must say whether the printing of the dump summary reports 
should continue. Valid responses are YES or NO. 


Commands That Detect Condition: 
PRTDUMP 
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263E 


2651 


Messages 


THE FORMATTING ROUTINE ‘routine name’ FOR ‘type’? COULD NOT BE 
FOUND 


Explanation: A specific formatting routine was not found on any disk accessed 
by the user. 


System Action: For DUMPSCAN and PRTDUMP, no user exit is taken and 
program product subcommands will not work. 


User Response: You must verify the name of the file you want to use and that it 
is located on a disk you have accessed. 


Commands That Detect Condition: 


Command Routine Type 

DUMPSCAN DMMDCM CMS 
CSTIDS GCS 
DVMZDS PVM 


DMTZDS RSCSNET 
CSTIDS RSCSV2 


PRTDUMP CSTIPR GCS 
CSTIPR RSCSV2 


SVC 199 IS CURRENTLY IN USE 


Explanation: The HNDSVC macro was issued for SVC 199 and that SVC 
number was already in use. 


System Action: DUMPSCAN or PRTDUMP processing continues, but program 
product subcommands will not be recognized. 


User Response: Determine which program is using SVC 199. That program 
cannot run concurrently with the dump viewing facility. 


Commands That Detect Condition: 


DUMPSCAN 
PRTDUMP 


PRINTING FORMATTED STORAGE IS NOT SUPPORTED BY THE DUMP 
VIEWING FACILITY 


Explanation: You have tried to print a formatted dump from 0 to the end with a 
program product formatting routine. This is not supported by the dump viewing 
facility. | 


System Action: The load maps, registers, and PSW will be printed. 


User Response: Use the DUMPLOAD command to print the formatted dump 
from 0 to the end. 


Commands That Detect Condition: 
PRTDUMP 
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Messages 


2661 THE ROUTINE routine name FOR spoolid CANNOT BE FOUND 
-— 
Explanation: The user exit necessary for a formatting routine was not found. A 
System Action: Processing continues. The trace entry record will be processed in 
hex mode. 
User Response: Run the TRACERED command again and be sure you are 
linked to the disks that contain the user exits. 
Commands That Detect Condition: 
TRACERED 
3001 : THE DUMP HAS NO MODULE MAP 
Explanation: A module map was not found at the end of the dump file currently 
being processed. 
System Action: If the FINDMOD subcommand was issued, subcommand proc- yee. 
essing is terminated and the dump viewing facility waits for a new subcommand . | 
to be entered. 
— If the PRTDUMP command was issued, printing of other dump data will con- 
tinue. A note will be printed in the output indicating that the module map was 
not available. 
User Response: The ADDMAP command may be used to append a module map 
to the dump file. 
Commands That Detect Condition: Paes 
FINDMOD subcommand of DUMPSCAN Ne ot 
PRTDUMP 
3011 DUMP filename filetype filemode ALREADY HAS A MODULE MAP 
Explanation: The specified dump file already has an appended module map. 
System Action: Message 302A is issued. 
User Response: None. a, 
Commands That Detect Condition: Soe 
ADDMAP 
302A DO YOU WANT TO REPLACE THE PREVIOUS MAP? ENTER YES OR 
NO 


Explanation: You are attempting to add a map to a dump that already has a — 
map appended. You have the option of replacing the pointer to the old map with 
a pointer to the new map. 


System Action: The dump viewing facility waits for a response. 


User Response: Enter one of the following: 


YES The new map will be appended to the dump and the pointer 
updated. 
NO Terminate the ADDMAP command. 


Any other response Reprompt. 
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310K 


311E 


315E 


Messages 


Commands That Detect Condition: 
ADDMAP 


THE MODULE MAP CANNOT BE APPENDED TO A type DUMP 


Explanation: You tried to append a module map to a dump of the type specified. 
The type is a soft abend. 


System Action: Command processing continues. 
User Response: None. 
Commands That Detect Condition: 

ADDMAP 


THE FILES filename filetype filemode AND filename filetype filemode ARE 
INCOMPATIBLE 


Explanation: The dump file and the module map file represent two different 
levels of the system. 


System Action: Command processing is terminated. 
User Response: Verify that the correct fileids were specified. 
Commands That Detect Condition: 

ADDMAP 


THE typel MODULE MAP FILE filename filetype filemode DOES NOT 
MATCH THE type2 DUMP filename filetype filemode 


Explanation: The type of the module map to be appended does not match the 
type of the dump. typel is a CP, CMS, PVM, or RSCS module map and type2 is 
the dump file type. 


System Action: Command processing is terminated and the module map is not 
appended to the dump. 


User Response: Verify that the correct fileids were specified on the command. 
Reenter the command with the correct files specified or enter another command. 


Commands That Detect Condition: 
ADDMAP 


THE PVM LOAD MAP filename filetype filemode OVERLAPS A PREVIOUS 
MAP 


Explanation: The address range of the PVM input load map overlaps either par- 
tially or completely the address range of the previously included CMS nucleus 
load map in the output dump viewing facility module map. 


System Action: Command processing is terminated and the module map is not 
created. 


User Response: Reenter the command with the proper input load maps. 
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Commands That Detect Condition: | 
MAP a 


3201 THE MODULE MAP filename filetype filemode HAS BEEN CREATED FROM 
LOAD MAP filename filetype filemode 


Explanation: The module map has been successfully created from the input load 
map. 


System Action: Command processing is finished. 
User Response: None. 


Commands That Detect Condition: 
MAP 


3211 THE MAP filename filetype filemode HAS BEEN APPENDED TO DUMP . oS 
filename ‘ / 


Explanation: The module map has been successfully appended to the dump indi- 
cated. 


System Action: Command processing is finished. 
User Response: None. 


Commands That Detect Condition: 
ADDMAP | gen 


3301 THE INPUT type LOAD MAP NAME IS filename filetype filemode 


Explanation: You entered a null line in response to a prompt for a load map 
name. Consequently, the MAP command substituted a predefined filename, 
filetype, and filemode. | 


Where the type is: 


CP NUCLEUS Yer 
CMS NUCLEUS 

PVM (secondary PVM load map) 
RSCSNET 

GCS NUCLEUS 

RSCSV2. 


System Action: Command processing continues. 
User Response: Continue or terminate command processing when possible. 
Commands That Detect Condition: 

MAP 


eS 
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3311 
3321 
3401 


( 3411 


Messages 


MAP TYPE IS CP 


Explanation: You entered a null line in response to prompting message 123A or 
the map type was not specified on the MAP command line. Consequently, CP 
map type processing will be used. 


System Action: Command processing continues. 
User Response: Continue or terminate command processing when possible. 
Commands That Detect Condition: 

MAP 


THE LOAD MAP filename filetype filemode HAS BEEN APPENDED TO 
MODULE MAP filename filetype filemode 


Explanation: The load map has been successfully appended to the module map. 
System Action: Command processing continues. 
User Response: None. 


Commands That Detect Condition: 
MAP 


DYNAMICALLY CREATING MODULE MAP 


Explanation: You entered the DUMPSCAN or PRTDUMP command with a CP 
dump on a writable disk that has no appended module map. A map is being built 
and appended to the dump file specified in the command. 


System Action: Command processing continues. 
User Response: None. 


Commands That Detect Condition: 


DUMPSCAN 
PRTDUMP 


DISK on IS READ ONLY, DYNAMIC MAP NOT CREATED 


Explanation: The disk containing the dump file you requested is a read-only disk. 
The module map cannot be appended to the dump. 


System Action: Command processing continues. 


User Response: If you do not need the functions of either the FINDMOD sub- 
command of the DUMPSCAN command or the module map summary of the 
PRTDUMP command, no response is necessary. If you do need these functions, 
copy the dump file to a CMS disk where you have write access. Then reissue the 
DUMPSCAN or PRTDUMP command specifying the dump file on the CMS 
disk to which you have write access. 


Commands That Detect Condition: 


DUMPSCAN 
PRTDUMP 
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3421 


3501 


351E 


3521 


INSUFFICIENT DASD SPACE, DYNAMIC MAP NOT CREATED 


Explanation: While the dump viewing facility attempted to append the dynam- 
ically created module map to the requested dump file, the disk containing the 
dump became full. The load map 1s not appended. 


System Action: Command processing continues. 


User Response: If you do not need the functions of either the FINDMOD sub- 
command of the DUMPSCAN command or the module map summary of the 
PRTDUMP command, no user response is necessary. If you do need these func- 
tions, delete any unwanted files from the disk containing the dump file to secure 
space for the appended module map. Then reissue the DUMPSCAN or 
PRTDUMP command. 


Commands That Detect Condition: 


DUMPSCAN 
PRTDUMP 


THE MODULE OR ENTRY POINT name WAS NOT IN STORAGE AT THE 
TIME OF THE DUMP 


Explanation: The specified module or entry point was not in real storage at the 
time of the dump. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 
Commands That Detect Condition: 
FINDMOD subcommand of DUMPSCAN 


THE ADDRESS address IS NOT IN A MODULE 


Explanation: The address specified on the FINDMOD subcommand Is not con- 
tained in any module in the dump. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 


Commands That Detect Condition: 
FINDMOD subcommand of DUMPSCAN 


THE MODULE OR ENTRY POINT name WAS NOT FOUND IN THE 
MODULE MAP | 


Explanation: The specified module or entry point name was not found in the 
module map appended to the dump. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 
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3531 
400E 
401I 


Messages 


User Response: Check if the correct module or entry point name was entered. 
Correct the name and reenter the subcommand, or enter a new subcommand. 


Commands That Detect Condition: 
FINDMOD subcommand of DUMPSCAN 


THE MODULE OR ENTRY POINT name IS LOCATED AT ADDRESS 
address 


Explanation: The specified module or entry point name was found to be in 
storage at the time of the dump, but the page was not included in the dump. 


System Action: This message will be followed by a message indicating why the 
page was not found. 


Subcommand processing is terminated and the dump viewing facility waits for a 
new subcommand. 


User Response: Enter a new subcommand. 
Commands That Detect Condition: 
FINDMOD subcommand of DUMPSCAN 


subcommand IS NOT A RECOGNIZED SUBCOMMAND 


Explanation: The indicated subcommand you issued is not a known 
DUMPSCAN subcommand. 


System Action: The dump viewing facility waits for you to enter another 
DUMPSCAN subcommand. 


User Response: Enter a new subcommand. 


Commands That Detect Condition: 
DUMPSCAN 


READY, DUMP TYPE IS type 


Explanation: This message is issued whenever DUMPSCAN is waiting for a sub- 
command. 


System Action: The dump viewing facility waits for the next subcommand. 
User Response: Enter a DUMPSCAN subcommand. 
Commands That Detect Condition: 

DUMPSCAN 


Note: The “type” value in the dump file will be used. 
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402E | THE subcommand SUBCOMMAND IS NOT VALID FOR type DUMPS 
Explanation: The DUMPSCAN subcommand entered is not valid for the speci- a - 
fied type of dumps. type is the dump type. | ea 


System Action: The subcommand is not processed. After issuing the message, 
the dump viewing facility waits for you to enter another subcommand. 


User Response: You may continue analyzing the dump by issuing a new subcom- 
mand. 


Commands That Detect Condition: 
DUMPSCAN 


403E : THE option OPTION IS NOT VALID FOR type DUMPS 


Explanation: The PRTDUMP option entered is not supported for the specified 
type of dump. 


System Action: Command processing is terminated. 
User Response: Correct and reenter the request, or enter a new request. 
Commands That Detect Condition: 

PRTDUMP 


404E THE ‘operand’ OPERAND IS NOT VALID FOR type DUMPS 


Explanation: When you issued a subcommand of DUMPSCAN, you entered an go 
operand that was not valid for that type of dump. 


System Action: The subcommand is terminated. DUMPSCAN waits for you to 
enter a new subcommand. 


User Response: Reissue the subcommand without using the specified operand. 
Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


405E THE IPCS SUBCOMMAND ‘subcommand’ IS NOT SUPPORTED FOR type Se. 
DUMPS 


Explanation: When you issued the IPCS subcommand, you entered a subcom- 
mand that is not supported for the specified type of dump. 


System Action: The subcommand is not processed. After issuing the message, 
the dump viewing facility waits for you to enter another subcommand. 


User Response: Issue a new subcommand to continue analyzing your dump. 
Commands That Detect Condition: 
DUMPSCAN 
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446I 


4471 


4481 


4491 


Messages 


BLOCK INITIALIZATION HAS STARTED, PLEASE BE PATIENT 


Explanation: The BLOCK subcommand 1s building the control block look-up 
table. | 


System Action: BLOCK will process the control block definitions specified in the 
control block. 


User Response: None. 
Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


BLOCK INITIALIZATION HAS COMPLETED SUCCESSFULLY 


Explanation: The BLOCK subcommand has been successful in building the 
look-up table. 


System Action: BLOCK will process the user request to display a control block. 
User Response: None. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


BLOCK INITALIZATION HAS FAILED 


Explanation: The BLOCK subcommand has been unsuccessful in the building of 
the look-up table. 


System Action: The subcommand is terminated. You will receive an additional 
message or messages indicating the cause of the error. 


User Response: Correct the error, then reenter the BLOCK subcommand. 
Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


UNABLE TO PROCESS THE BLOCK SUBCOMMAND 


Explanation: The BLOCK subcommand cannot be executed because of an error 
condition. 


System Action: The subcommand is terminated. You will receive a second 
message to further explain the error. 


User Response: Correct the error, then reenter the BLOCK subcommand. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 
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Messages 


4501 THE BLOCK TABLE ‘tablename’ WAS NOT FOUND © 


Explanation: The indicated block table name was not found on any disk you | 
have accessed. 


System Action: Command processing continues, but the BLOCK subcommand 
cannot format control blocks contained in the specified table. 


User Response: You can terminate the DUMPSCAN command, then access the 
disk containing the table. Reenter the DUMPSCAN command and then the | 
BLOCK subcommand. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


4311 THE ‘cbname’ CONTROL BLOCK CANNOT BE FOUND IN ANY BLOCK 
TABLE 


Explanation: The control block name you specified was not found in any of the | . 
BLOCK table files. 2 


System Action: Subcommand processing is terminated. 


User Response: Reenter the BLOCK subcommand with a correct control block 
name. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


4521 THE FIELD ‘field name’? WAS NOT FOUND Se 


Explanation: The field name you specified was not found in the block table entry 
for that control block. 


System Action: You will receive message 455A which reprompts you for the 
correct field name. Any field names already entered that were correct will be 
saved and used by the BLOCK subcommand. 


User Response: Reenter the field name correctly or end the prompt. aa 
Commands That Detect Condition: hoe 
BLOCK subcommand of DUMPSCAN 


4541 UNKNOWN CONTROL BLOCK ID, RE-ENTER BLOCK SUBCOMMAND 
USING THE CONTROL BLOCK NAME 


Explanation: You entered an asterisk (*) for a control block name. The dump 
viewing facility could not find the actual control block name in its internal table. 


System Action: The subcommand is terminated and DUMPSCAN waits for you 
to enter a new subcommand. 


User Response: Reenter the BLOCK subcommand using the control block name 
instead of an asterisk. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 
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455A 


456I 


457K 


458E 


Messages 


ENTER FIELD NAME(S) TO BE FORMATTED, QUIT TO END SUBCOM- 
MAND OR NULL LINE TO END PROMPT 


Explanation: This is a prompt for you to enter the names of specific fields for 
formatting. 


System Action: The system waits for your response. 


User Response: You should enter either the field names, separated by blanks, or 
a null line to indicate that there are no more field names requested. If you enter 
QUIT, the BLOCK subcommand processing ends. If you enter a null line in 
response to the first prompt, only entries flagged as default fields are formatted. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


TOO MANY FIELD NAMES SPECIFIED. THE EXTRA ARE IGNORED 
Explanation: You have requested more than 512 field names for formatting. 


System Action: The first 512 field names will be used. The extra ones are 
ignored. You will not be prompted for more control block names and processing 
continues. 


User Response: None. If you want to see more than 512 fields, reenter the 
BLOCK subcommand and specify ALL instead of PROMPT. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


BLOCK SUBCOMMAND NOT SUPPORTED FOR type DUMP 


Explanation: The BLOCK subcommand is not supported for the specified type of 
dump. 


System Action: The subcommand is terminated and DUMPSCAN waits for a 
new subcommand to be entered. 


User Response: Enter a new subcommand. 
Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


THE CONTROL FILE filename filetype WAS NOT FOUND 


Explanation: The BLOCK subcommand is not supported because a control file 
was not found for the specified type of dump you requested. 


User Response: You should access the disk containing the necessary control file 
and reenter the DUMPSCAN command, or you should issue another subcom- 
mand. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 
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459E CANNOT LOCATE ANY OF THE BLOCK TABLE FILES 


Explanation: The dump viewing facility cannot locate any of the BLOCK table 
files used to format control blocks. 


System Action: The subcommand is terminated and DUMPSCAN waits for a 
new subcommand to be entered. 


User Response: Access the disk containing the BLOCK tables and reenter the 
BLOCK subcommand, or issue another subcommand. 


Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


3101 THE &NAME TABLE IS FULL 


Explanation: The space available in the &name table is not sufficient for the 
entry being added. 


System Action: The dump viewing facility waits for the next subcommand. 


User Response: You may redefine previous entries with shorter entries to make 
space available in the &name table, or you may enter a new subcommand. 


Commands That Detect Condition: 
&name subcommand of DUMPSCAN 


SI1E &name IS NOT IN THE &NAME TABLE 
Explanation: You invoked “&name” and it was not in the table. c 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. | 


User Response: Enter the & subcommand to list all entries in the table and then 
reenter a valid &name or any other DUMPSCAN subcommand. 


Commands That Detect Condition: 
DUMPSCAN 


5121 THE &NAME TABLE IS EMPTY 
Explanation: There are no entries in the &name table. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Use the &name subcommand to add entries to the &name table 
or enter another DUMPSCAN subcommand. 


Commands That Detect Condition: 
&name subcommand of DUMPSCAN 
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5201 A LOOP WAS DETECTED IN THE type CHAIN 


( : Explanation: An unexpected loop was detected in the specified control block 
Ke chain currently being processed. | 


System Action: If a DUMPSCAN subcommand was issued, subcommand proc- 
essing is terminated with the detection of the loop. Any output that was com- 
pleted before the detection of the loop will be displayed. 


If the PRTDUMP command was issued, this message is printed in the output to 
indicate why the particular summary report was not complete. A message will be 
issued indicating that the summary report being processed is not complete. The 
printing of other dump data continues. 


User Response: If you are in DUMPSCAN mode, you may enter a new subcom- 
mand. 


Commands That Detect Condition: 


io Command Type 
( PRTDUMP VMDBK 
i CHAIN subcommand CONTROL BLOCK 
VIOBLOK subcommand VMDBK 
VMDBK subcommand VMDBK 
S211 CONTROL BLOCK AT address POINTS TO CONTROL BLOCK AT address 


Explanation: The control block at the address specified points to another control 
block already in the chain. 


( s System Action: Additional informational messages will be issued. Then subcom- 
mand processing terminates. 


User Response: None. 
Commands That Detect Condition: 
CHAIN subcommand of DUMPSCAN 


( ie 5221 CONTROL BLOCK #nnnn POINTS TO CONTROL BLOCK #nonnn 


Explanation: The control block specified by the variable “nnnn” points to 
another control block specified by the second “nnnn” variable that 1s already in 
the chain. 


System Action: An additional informational message may be issued. Then sub- 
command processing terminates. 


User Response: Enter a new subcommand. 


Commands That Detect Condition: 
CHAIN subcommand of DUMPSCAN 
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3231 


524] 


5251 


5261 


S271 


nnnn ENTRIES WERE FOUND IN THE CHAIN 
Explanation: This message tells you how many entries were found in the chain. —_ 
System Action: The dump viewing facility waits for a new subcommand. 
User Response: Enter a new subcommand. | 
Commands That Detect Condition: 

CHAIN subcommand of DUMPSCAN 


THE FIRST CONTROL BLOCK POINTS TO ITSELF 
Explanation: The first control block on a chain points to itself. 
System Action: Subcommand processing terminates. 

User Response: Enter a new subcommand. 


Commands That Detect Condition: 
CHAIN subcommand of DUMPSCAN 


CB # nnnn AT address 


Explanation: The control block specified by the variable “nnnn” is located at the 
address indicated by the variable “address”. 


System Action: Subcommand processing continues. 

User Response: None. | 

Commands That Detect Condition: ee 
CHAIN subcommand of DUMPSCAN 


THE LAST CONTROL BLOCK POINTS TO THE FIRST 


Explanation: The last control block on a chain points to the first control block 
on the same chain. This message appears for noncyclic chains only. 


System Action: Subcommand processing terminates. 
User Response: Enter a new subcommand. 
Commands That Detect Condition: 

CHAIN subcommand of DUMPSCAN 


THE LAST CONTROL BLOCK POINTS TO ITSELF 
Explanation: The last control block on a chain points to itself. 
System Action: Subcommand processing terminates. 

User Response: Enter a new subcommand. 


Commands That Detect Condition: 
CHAIN subcommand of DUMPSCAN 
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5291 


5301 


S40E 


Messages 


CHAIN MAXIMUM OF 4096 CONTROL BLOCKS REACHED 


Explanation: The maximum number of entries is 4096 in a chain for which the 
CHAIN subcommand is able to detect a loop. That maximum has been reached. 


System Action: The system waits for a null line (the null line subcommand) or 
another subcommand to be entered. 


User Response: If you wish to continue CHAIN subcommand processing for this 
chain, enter a null line (the null line subcommand). Subcommand processing then 
continues from the last entry found. 


Commands That Detect Condition: 
CHAIN subcommand of DUMPSCAN 


nonn ENTRIES - PROCESSING CONTINUES 


Explanation: You entered the COUNT operand on the CHAIN subcommand. 
The subcommand is working. 


System Action: System processing continues. 
User Response: None. 


Commands That Detect Condition: 
CHAIN subcommand of DUMPSCAN 


THE STRING string WAS NOT FOUND 


Explanation: The string (hexadecimal or EBCDIC) was not found between the 
starting and ending addresses specified on the input. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 
Commands That Detect Condition: 


LOCATE subcommand of DUMPSCAN 
LOCATEUP subcommand of DUMPSCAN 


THE STARTING ADDRESS address MUST BE LESS THAN THE ENDING 
ADDRESS 


Explanation: The starting address specified with the LOCATE subcommand is 
greater than the ending address. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Correct the input and reenter the subcommand or enter a new 
subcommand. 


Commands That Detect Condition: 
LOCATE subcommand of DUMPSCAN 
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S41E 


3431 


S44E 


S45E 


THE STARTING ADDRESS address MUST BE GREATER THAN THAN THE 


ENDING ADDRESS es 


Explanation: The starting address specified with the LOCATE subcommand is ) ees 
less than the ending address. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Correct the input and reenter the subcommand or enter a new 
subcommand. 


Commands That Detect Condition: 
LOCATEUP subcommand of DUMPSCAN 


THE BEGINNING OF THE DUMP WAS REACHED 
Explanation: The beginning of the dump was reached. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 


Commands That Detect Condition: 


~ subcommand of DUMPSCAN 
BACKWARD subcommand of DUMPSCAN 
SCROLLUP subcommand of DUMPSCAN 


A VALID SCROLLING ADDRESS HAS NOT YET BEEN ESTABLISHED nee 


Explanation: A FORWARD or BACKWARD request must follow some other 
request that generates a display address. This has not yet happened in this 
DUMPSCAN session. 


System Action: The dump viewing facility waits for a new subcommand. 


User Response: Enter an address in the area you wish to examine by using a sub- 
command such as DISPLAY or LOCATE, or enter a new subcommand. 


Commands That Detect Condition: \ 


~ subcommand of DUMPSCAN 
+ subcommand of DUMPSCAN 
BACKWARD subcommand of DUMPSCAN 
FORWARD subcommand of DUMPSCAN 
SCROLL subcommand of DUMPSCAN 
SCROLLUP subcommand of DUMPSCAN 


SCROLLING BEYOND OFESET offset IS INVALID 


Explanation: The OFFSET value has gone beyond 0 or hex FFFO while using 
one of the following subcommands: FORWARD, BACKWARD, SCROLL, 
SCROLLUP, +, or -. 


System Action: The dump viewing facility waits for a new subcommand. 


User Response: Either set the OFFSET value within the limits by entering the = 
appropriate FORWARD, BACKWARD, SCROLL, SCROLLUP, +, or - sub- a 
command or enter another DISPLAY subcommand. 
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5601 


5701 


Messages 


Commands That Detect Condition: 


Command Offset (Hex) 
+ subcommand of DUMPSCAN 0 or FFFO 
- subcommand of DUMPSCAN 0 or FFFO 
BACKWARD subcommand of DUMPSCAN 0 or FFFO 
FORWARD subcommand of DUMPSCAN QO or FFFO 
SCROLL subcommand of DUMPSCAN 0 or FFFO 
SCROLLUP subcommand of DUMPSCAN 0 or FFFO 


THE CPU ADDRESS cpuaddr IS NOT IN THE DUMP 


Explanation: You tried to display or refer to a CPU address that was not in the 
dump. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand or use the CPU subcommand to deter- 
mine which processors are in the dump. 


Commands That Detect Condition: 


CREGS subcommand of DUMPSCAN 
GREGS subcommand of DUMPSCAN 
REGS subcommand of DUMPSCAN 
TRACE subcommand of DUMPSCAN 
VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 
VSTAT subcommand of DUMPSCAN 


VECTOR INFORMATION IS NOT AVAILABLE FOR THIS VIRTUAL 
MACHINE 


Explanation: The dump being viewed by DUMPSCAN contains no vector reg- 
ister contents or status for any virtual CPU. You have requested vector informa- 
tion for a virtual machine where the Vector Facility was one of the following: 


e Undefined 
¢ Never used 
¢ Unavailable due to Vector Facility failure. 


System Action: The subcommand is terminated and DUMPSCAN waits for a 
new subcommand to be entered. 


User Response: Ensure that the correct dump is being viewed. 
Commands That Detect Condition: 


VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 
VSTAT subcommand of DUMPSCAN 
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S71L ee VECTOR INFORMATION IS NOT AVAILABLE FOR THIS CPU 


Explanation: Although vector information is available in the dump being viewed, 
the Vector Facility was not defined or not functional for the processor requested, ‘ee 
or no data had been placed in it. 


FOS 
id yy 
\ 
a 


System Action: The subcommand is terminated and DUMPSCAN waits for a 
new subcommand to be entered. 


User Response: Issue the subcommand without specifying a CPU address. Or, 
correct the address specified. You can use the CPU subcommand of 
DUMPSCAN to obtain all processor identifiers in the dump. 


Commands That Detect Condition: 


VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 
VSTAT subcommand of DUMPSCAN 


576K SPECIFYING AN ODD REGISTER IS INVALID FOR VPAIR 


Explanation: You specified an odd register as the starting or ending register for 
the VPAIR subcommand. Only even number register pairs can be specified. 


System Action: Subcommand processing terminates. The dump viewing facility 
waits for a new subcommand. 


User Response: Reenter the VPAIR subcommand specifying even register 
numbers as operands. 


Commands That Detect Condition: _ pers 
VPAIR subcommand of DUMPSCAN ee 
577E THE STARTING REGISTER IS GREATER THAN THE ENDING REGISTER 


Explanation: You entered a range of registers in which the first register was 
larger than the last. 


System Action: Subcommand processing terminates. The dump viewing facility 
waits for a new subcommand. 


User Response: Reenter the subcommand specifying a valid range of registers. Ly 
Commands That Detect Condition: 


VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 


578E THE STARTING ELEMENT IS GREATER THAN THE ENDING ELEMENT 


Explanation: You entered a range of elements in which the first element was 
larger than the last. 


System Action: Subcommand processing terminates. The dump viewing facility 
waits for a new subcommand. 


User Response: Reenter the subcommand specifying a valid range of elements. 
Commands That Detect Condition: 


VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 
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580E 


600] 


601T 


Messages 


THE REGISTER OPERAND ‘operand’ IS GREATER THAN number CHARAC- 
TERS 


Explanation: When you entered the VPAIR or VREG subcommand, you speci- 
fied characters in excess of the maximum number allowed for a register operand. 
For example, you entered “003” when only two characters are permitted. 


System Action: Subcommand processing terminates. The dump viewing facility 
waits for a new subcommand. 


User Response: Reenter the subcommand specifying a valid register number. 
Commands That Detect Condition: 


VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 


THE ELEMENT OPERAND ‘operand’ IS GREATER THAN number CHARAC- 
TERS 


Explanation: When you entered the VPAIR or VREG subcommand, you speci- 
fied characters in excess the maximum number allowed for an element operand. 
For example, you entered “0123” when only three characters are permitted. 


System Action: Subcommand processing terminates. The dump viewing facility 


- waits for a new subcommand. 


User Response: Reenter the subcommand specifying a valid register number. 


Commands That Detect Condition: 


VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 


NO VALID TRACE ENTRIES WERE FOUND FOR CPU ADDRESS cpuaddr 


Explanation: The value contained in control register 12 for the specified 
processor pointed to an invalid trace entry that did not contain hex 74 in the first 
byte. 


System Action: Subcommand processing is terminated and the dump viewing — 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 


Commands That Detect Condition: 
TRACE subcommand of DUMPSCAN 


NO VALID TRACE ENTRY WAS FOUND AT ADDRESS address 


Explanation: The input address pointed to an invalid trace entry that did not 
contain hex 74 in the first byte. 7 


System Action: If the command was DUMPSCAN, subcommand processing is 
terminated and the dump viewing facility waits for a new subcommand. 


If the command was PRTDUMP, message 602I will be printed in the summary 
report and processing continues. 
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User Response: Enter a new subcommand. 


~ Commands That Detect Condition: 


PRTDUMP 
TRACE subcommand of DUMPSCAN 


6021 THE TRACE SUMMARY WILL CONTINUE WITHOUT CPU cpuaddr 


Explanation: An error occurred preventing the trace function of PRTDUMP 
from locating all or some of the trace entries for the processor indicated. 


System Action: The summary printout continues without the identified processor. 


The summary will contain a list of all merged trace entries up to the point of 
error, and all except those from the identified processor after the error. 


User Response: None. 
Commands That Detect Condition: 
PRTDUMP 


6031 THE TRACE ENTRY AT address IS NOT IN THE TRACE TABLE FOR CPU 
cpuaddr 


Explanation: The address specified by the FROM keyword in the command is 
missing from either of the following: 


¢ The trace table for the processor specified, if the command includes a single 
processor address 


e All trace tables for all processors whose dumps were to be merged, if the 
command specifies or defaults to ALL. 


System Action: Subcommand processing terminates. DUMPSCAN waits for a 
new subcommand to be entered. 


User Response: Correct the FROM address or the CPU address and reenter the 
subcommand. Or, enter another DUMPSCAN subcommand, HX, END, or 
QUIT. 


Commands That Detect Condition: 
TRACE subcommand of DUMPSCAN 


6101 THERE IS NO SELECTION CRITERIA IN EFFECT 


Explanation: You issued SELECT QUERY but you have not previously speci- 
fied any selection criteria. | 


System Action: Subcommand processing terminates. DUMPSCAN waits for a 
new subcommand to be entered. 


User Response: Enter any DUMPSCAN subcommand. 


Commands That Detect Condition: 
SELECT subcommand of DUMPSCAN 
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6111 


6201 


6211 


Messages 


THE USER ‘userid’? DOES NOT APPEAR IN THE DUMP 
Explanation: The userid you specified is not located in the dump file. 


System Action: Subcommand processing for the requested userid is terminated. 
The userid you specified is not saved for future trace table entry selection. 


Subcommand processing is continued for any other userid that may be requested 
in the same SELECT invocation. 


User Response: Correct the input and reenter the SELECT subcommand or a 
new subcommand. 


Commands That Detect Condition: 
SELECT subcommand of DUMPSCAN 


THE VMDBK FOR USER userid DOES NOT EXIST IN THE DUMP 
Explanation: The VMDBK for the specified userid did not exist in the dump. 


System Action: Ifa DUMPSCAN subcommand was issued, subcommand proc- 
essing is terminated and the dump viewing facility waits for a new subcommand. 


If the PRTDUMP command was issued, printing of other dump data continues. 
This message will also be printed in the output to indicate why the virtual 
machine summary report for this user was not printed. 


User Response: If the userid did not exist in the dump, you may issue the 
VMDBK subcommand of the DUMPSCAN command or you may refer to the 
printed VMDBK summary report to see what userids are contained in the dump. 
You may reissue the PRTDUMP command or, if you are in DUMPSCAN mode, 
you may issue a subcommand. 


Commands That Detect Condition: 


PRTDUMP 
VIOBLOK subcommand of DUMPSCAN 
VMDBK  subcommand of DUMPSCAN 


THERE IS NOT ENOUGH STORAGE IN AN INTERNAL TABLE FOR THE 
non ENTRIES FOUND IN THE DUMP 


Explanation: While building the internal dump viewing facility VMDBK table, 
the number of VMDBKs found in the global cyclic list exceeded the number of 
available entries in the table. 


System Action: Processing continues for the subcommand, if possible. 


User Response: If the command was DUMPSCAN, enter a new subcommand. 
This condition should be reported to your system programmer. 


Commands That Detect Condition: 


PRTDUMP | 
VIOBLOK subcommand of DUMPSCAN 
VMDBK  subcommand of DUMPSCAN 
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622E ‘field? IS NOT A RECOGNIZED VMDBK FIELD 
Explanation: The name of a VMDBK field has been specified that the VMDBK a” : 
subcommand does not recognize. | We 


System Action: The specified field name is not processed. Subcommand proc- 
essing will continue to display other requested fields. 


User Response: Check if the specified field name has been spelled correctly. 
Then check the table of valid field names supported by the dump viewing facility. 
Correct and reenter the subcommand or enter a new subcommand. 


Commands That Detect Condition: 
VMDBK subcommand of DUMPSCAN 


6231 DUPLICATE USERIDS WERE FOUND IN THE VMDBK CHAIN 


Explanation: While processing the VMDBK global cyclic list, at least two 
VMDBKs were found with the same userid. 


System Action: Processing continues, if possible. 
User Response: None. 


Commands That Detect Condition: 


PRTDUMP 
VIOBLOK subcommand of DUMPSCAN 
VMDBK  subcommand of DUMPSCAN 


6241 USERID userid IS A DUPLICATE USERID ane 


Explanation: You requested information for the specified userid. More than one 
VMDBK was found with this userid. 


System Action: If you issued the DOUMPSCAN subcommand, command proc- 
essing terminates. If you issued the PRTDUMP command, no report for the 
requested userid is printed. 


User Response: First issue the VMDBK LIST subcommand and determine the 
address of the VMDBK desired. Then issue the VMDBK FOR address command | . 
to display a summary of the VMDBK. are 


Commands That Detect Condition: 


PRTDUMP 
VIOBLOK subcommand of DUMPSCAN 
VMDBK subcommand of DUMPSCAN 
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6411 


6421 


. Messages 


THE VIRTUAL type value FOR USER userid DOES NOT EXIST IN THE 
DUMP 


Explanation: The virtual device for the device number or subchannel number 
specified did not exist in the dump for this user. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 


Commands That Detect Condition: 


Subcommand Type 
VIOBLOK subcommand of DUMPSCAN DEVICE 
SUBCHANNEL 


THE type device DOES NOT EXIST IN THE DUMP 


Explanation: The device for the real device or logical device specified did not 
exist in the dump. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Enter a new subcommand. 
Commands That Detect Condition: 
Subcommand Type 


RIOBLOK subcommand of DUMPSCAN LOGICAL DEVICE 
REAL DEVICE 


NO type [FOR USER userid] COULD BE FOUND 


Explanation: No I/O device blocks of the specified type could be found in the 
dump. 


System Action: The printing of other dump data continues. 
User Response: None. 


Commands That Detect Condition: 


Command Type 

PRTDUMP REA DEVICES 
VIRTUAL DEVICES 

RIOBLOK subcommand of DUMPSCAN REAL DEVICES 
LOGICAL DEVICES 

VIOBLOK subcommand of DUMPSCAN VIRTUAL DEVICES 


VIRTUAL SUBCHANNELS 
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6431 


6601 


6611 


THE type DEVICE BLOCKS FOR DEVICES nonn TO mmmm ARE NOT 
AVAILABLE 


Explanation: The I/O device blocks of the Eee type in the indicated range 
could not be found in the dump. 


System Action: The printing of other dump data continues. 
User Response: None. 


Commands That Detect Condition: 


Command Type 
PRTDUMP REAL 
VIRTUAL. 


THE ENTRY AT address IS NOT WITHIN THE FRAME TABLE 


Explanation: The address specified by the user is not the address of an entry in 
the frame table. 


System Action: Processing continues and the storage at the frame table entry 
address is formatted and displayed. 


User Response: Enter a new subcommand. 
Commands That Detect Condition: 
FRAMETBL subcommand of DUMPSCAN 


THE ENDING ADDRESS OF THE FRAME TABLE IS BEYOND THE DUMP 
STORAGE SIZE OF size 


Explanation: The upper boundary of the frame table exceeds the size of the 
dump. 


System Action: If the command was DUMPSCAN, the entry is displayed, if pos- 
sible. 


If the command was PRTDUMP, the FRAMETBL summary 1s not complete. 
User Response: If you are in DUMPSCAN, enter a new subcommand. 


Commands That Detect Condition: 


PRTDUMP 
FRAMETBL subcommand of DUMPSCAN 
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690] 


7011 


Messages 


NO SNAP DATA IS PRESENT 


Explanation: The soft abend dump you requested for processing contains no 
SNAPLIST data or snapped save areas. 


System Action: DUMPSCAN processing continues. 
User Response: Enter any DUMPSCAN subcommand. 


Commands That Detect Condition: 
SNAPLIST subcommand of DUMPSCAN 


THE DUMP SYMPTOM RECORD IS MISSING FROM FILE filename DUMP 
filemode 


Explanation: The first record of the specified dump file is not a valid dump 
symptom record. The first two bytes should contain the characters “SR” and 
they do not. 


System Action: If the SYMPTOM subcommand was issued, no summary infor- 
mation is displayed and the subcommand is terminated. The dump viewing 
facility waits for a new subcommand. 


If the PRTDUMP command was issued, you will be prompted to specify whether 
printing of the dump summary reports should continue. 


Note: Results of further processing are unpredictable. 


User Response: IBM recommends that you verify that the specified fileid actually 
contains a valid VM/XA SP CP abend, stand-alone, virtual machine, or soft- 
abend dump. The user may continue analyzing the dump. 


Commands That Detect Condition: 


DUMPSCAN 
PRTDUMP 
SYMPTOM subcommand of DUMPSCAN 


THE type ADDRESS address MUST BE ON A boundary BOUNDARY 


Explanation: An address needed for processing was not on the correct boundary 
for the type of address. The address may be one that was specified on the sub- 
command line, or may be an intermediary address used in processing. 


System Action: If the error was encountered while processing a DUMPSCAN 
subcommand, subcommand processing continues if possible. If the error was 
encountered in PRTDUMP, the printing of other dump data will continue. 


User Response: If you specified the address on a DUMPSCAN subcommand, 
you may correct the specified input address and reissue the subcommand, or enter 
a new subcommand. 
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Commands That Detect Condition: 


Subcommand Type | Boundary a 
PRTDUMP CHRBK DOUBLEWORD ve 
FRAME TABLE 4K 

RDEV DOUBLEWORD 


SYSTEM COMMON AREA 4K 
TRACE TABLE PAGE 4K 


VDEV DOUBLEWORD 
VMDBK AK 
FRAMETBL subcommand of DUMPSCAN FRAME TABLE AK 
FRAME TABLE ENTRY 16 BYTE 
RIOBLOK subcommand of DUMPSCAN CHRBK DOUBLEWORD 
RDEV DOUBLEWORD 
RSPBK DOUBLEWORD 
SYSTEM COMMON AREA 4K 
VMDBK 4K 
IORBK DOUBLEWORD 
TRACE subcommand of DUMPSCAN TRACE TABLE ENTRY 32 BYTE ge 
TRACE TABLE PAGE 4K | —_ 
VIOBLOK subcommand of DUMPSCAN CACBK DOUBLEWORD ‘ 
CHRBK DOUBLEWORD 
IORBK DOUBLEWORD 
RDEV DOUBLEWORD 
SYSTEM COMMON AREA 4K 
VDEV © DOUBLEWORD 
VDSBK DOUBLEWORD 
VMDBK 4K 
VMDBK = subcommand of DUMPSCAN VMDBK 4K BR 
7021 THE type ADDRESS address EQUALS OR EXCEEDS THE DUMP STORAGE 
SIZE OF size | 
Explanation: The address to be displayed or referenced equaled or exceeded the 
storage size of the dump. 
System Action: Ifa DUMPSCAN subcommand was issued, subcommand proc- 
essing continues, if possible. 
If the PRTDUMP command was issued, the printing of other dump data con- ; 


tinues. 


User Response: If the address specified was on a DUMPSCAN subcommand, 
correct the specified input address and reenter the subcommand, or enter a new 
subcommand. 
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Commands That Detect Condition: 


Command Type 


ADDMAP SYSTEM VMDBK 
SYSTEM SEGMENT TABLE 
SYSTEM PAGE TABLE 
PRTDUMP ADDRESS OF RADIX TREE 
CHRBK 
FRAME TABLE 
REAL DEVICE BLOCK 
SYSTEM COMMON AREA 
TRACE TABLE PAGE 
VIRTUAL DEVICE BLOCK 
VMDBK 


Subcommands Type 


7 - subcommand of DUMPSCAN 
( + subcommand of DUMPSCAN 
) BACKWARD subcommand of DUMPSCAN 
CHAIN subcommand of DUMPSCAN 
DISPLAY subcommand of DUMPSCAN 
FINDMOD subcommand of DUMPSCAN 
FRAMETBL subcommand of DUMPSCAN FRAME TABLE 
FRAME TABLE ENTRY 
LOCATE subcommand of DUMPSCAN 
LOCATEUP subcommand of DUMPSCAN 
RIOBLOK subcommand of DUMPSCAN ADDRESS OF RADIX TREE 


eo ., CHRBK 
: IORBK 


RADIX TREE 
REAL DEVICE BLOCK 
RSPBK 
VMDBK 
SCROLL subcommand of DUMPSCAN 
SCROLLUP subcommand of DUMPSCAN 
SNAPLIST subcommand of DUMPSCAN 
TRACE subcommand of DUMPSCAN TRACE TABLE PAGE 
ae VIOBLOK subcommand of DUMPSCAN CACBK 
( CHRBK 
IORBK 
REAL DEVICE BLOCK 
SYSTEM COMMON AREA 
VIRTUAL DEVICE BLOCK 
VMDBK 
VMDBK subcommand of DUMPSCAN VMDBK 


7031 THE type ADDRESS IS ZERO 


Explanation: The address represented by “type” or mentioned in a previous 
message 1s zero. 


System Action: If the error was encountered while processing a DUMPSCAN 
subcommand, subcommand processing continues, if possible. 


If the error was encountered in PRTDUMP, the printing of other dump data con- 
tinues. | 
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7201 


User Response: If you specified the address on a DUMPSCAN subcommand, 
you may correct the specified input address and reenter the subcommand, or enter 


a new subcommand. 
Commands That Detect Condition: 
Subcommand 


ADDMAP 


PRTDUMP 


FRAMETBL subcommand of DUMPSCAN 
RIOBLOK subcommand of DUMPSCAN 


VIOBLOK subcommand of DUMPSCAN 


VMDBK subcommand of DUMPSCAN 


THE type CHAIN IS BROKEN 


Type 


SYSTEM VMDBK 

SYSTEM SEGMENT TABLE 
SYSTEM PAGE TABLE 
ADDRESS OF RADIX TREE 
CHRBK 

FRAME TABLE 

RDEV 

SYSTEM COMMON AREA 
VDEV 

VMDBK 

FRAME TABLE 

ADDRESS OF RADIX TREE 
RADIX TREE 

RDEV 

RSPBK 

SYSTEM COMMON AREA 
CACBK 

RADIX TREE 

SYSTEM COMMON AREA 
VDEV 

VDSBK 

VMDBK 

VMDBK PAGE 


Explanation: The specified control block chain was not complete in the dump 
because either an invalid pointer was found or a necessary page was not in the 


dump. 


_ System Action: Ifa DUMPSCAN subcommand was issued, subcommand proc- 


essing is terminated with the detection of a broken chain. Any output nat was 
completed before the detection of the broken chain is displayed. 


If the PRTDUMP command was issued, the printing of other dump data con- 
tinues. A message is displayed indicating that the summary report currently being 
printed is incomplete. The partial summary report will indicate where the chain 


was broken. 


User Response: If you are in DUMPSCAN, you may enter a new subcommand. 


Commands That Detect Condition: 
Subcommand Type 


RIOBLOK REAL DEVICE 


LOGICAL DEVICE 


VIOBLOK | VMDBK 


VIRTUAL DEVICE 
VIRTUAL SUBCHANNEL 


VMDBK | VMDBK 
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_ Messages 


THE type PAGE WITH ADDRESS address IS NOT IN THE DUMP 


Explanation: In attempting to locate data in the dump, a pointer referenced a 


page that was not in the dump. 


System Action: If the error was encountered while processing a DUMPSCAN 
subcommand, subcommand processing continues, if possible. 


If the error was encountered while in PRTDUMP, the printing of other dump 


data will continue. 


User Response: If you specified the address on a DUMPSCAN subcommand, 
you may correct the specified input address and reenter the subcommand, or enter 


a new subcommand. 


Commands That Detect Condition: 


Command 


ADDMAP 


PRTDUMP 


Subcommands Page 


FRAMETBL subcommand of DUMPSCAN 
RIOBLOK subcommand of DUMPSCAN 


TRACE subcommand of DUMPSCAN 
VIOBLOK subcommand of DUMPSCAN 


VMDBK subcommand of DUMPSCAN 
All other subcommands of DUMPSCAN 


Page Type 


SYSTEM PAGE TABLE 
SYSTEM SEGMENT TABLE 
SYSTEM VMDBK 

CHRBK 

FRAME TABLE 

REAL DEVICE BLOCK 
SYSTEM COMMON AREA 
TRACE TABLE PAGE 
VIRTUAL DEVICE BLOCK 
VMDBK 


Type 


FRAME TABLE 

CHRBK 

TORBK 

RADIX TREE 

RDEV 

RSPBK 

SYSTEM COMMON AREA 
VDEV 

VMDBK 

TRACE TABLE 

CACBK 

CHRBK 

TORBK 

RDEV 

SYSTEM COMMON AREA 
VDEV 

VDSBK 

VMDBK 

VMDBK 


THE DATA IN PAGE address HAS CHANGED SINCE THE SOFT ABEND 


OCCURRED 


Explanation: The soft abend processor found a change in the data on this page 
between the time the abend was issued and when the page was written to the 


dump spool file. 


System Action: Subcommand processing continues. 
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7401 


7A1I 


7301 


User Response: The subcommand SNAPLIST can be used to determine if the 
data contained in those pages was preserved. 


Commands That Detect Condition: 


Any DUMPSCAN subcommand that displays storage can issue this message. 


THE PREFIX PAGE COULD NOT BE FOUND. 


Explanation: The pointer to the prefix page was either zero, not on a 4K-byte 
boundary, or pointed to an address that was not in the dump. 


System Action: Processing continues, if possible. 
User Response: Enter a new subcommand. 


Commands That Detect Condition: 


ADDMAP 

DUMPSCAN 

PRTDUMP 

CPU subcommand of DUMPSCAN 
FRAMETBL subcommand of DUMPSCAN 
REGS subcommand of DUMPSCAN 
RIOBLOK subcommand of DUMPSCAN 
VIOBLOK subcommand of DUMPSCAN 
VMDBK subcommand of DUMPSCAN 


THE PREFIX PAGE FOR CPU cpuaddr IS NOT AVAILABLE 


Explanation: The prefix page for the specified processor was not in the dump, or 
the page could not be read, or the prefix page could not be located. 


System Action: Processing continues, if possible. 
User Response: None. 
Commands That Detect Condition: 

PRTDUMP 


DUMPID DATA WAS NOT PROVIDED 


Explanation: The “dumpid” operand of the VMDUMP command was not used 
to provide descriptive text of the dump. 


System Action: Subcommand processing is terminated. 
User Response: None. 
Commands That Detect Condition: 


DUMPID subcommand of DUMPSCAN 
PRTDUMP 
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8001 THE EXTRA OPERAND ‘operand’ IS IGNORED 
Explanation: A valid operand (other than USER) is specified multiple times. 


System Action: Printing of other dump data will continue. 
User Response: None. 
Commands That Detect Condition: 

PRTDUMP 


S801E THE OPERAND ‘operand’ IS NOT VALID 


Explanation: The operand specified on the command line was not a recognized 
operand. 


System Action: Command or subcommand processing 1s terminated, or you are 
prompted for the correct operand. : 


a User Response: If prompted, enter the correct operand, or correct and reenter the 
request, or else enter a new request. 


Commands That Detect Condition: 


All commands and subcommands 


802E THE REQUIRED operand OPERAND IS MISSING 
Explanation: A required operand was not specified on the command line. 


( - System Action: Command or subcommand processing is terminated with the 
exception of TRACERED selection prompts. 


User Response: Correct and reenter the request, or enter a new request. 


Commands That Detect Condition: 


All commands and subcommands 


803E TOO {MANY|FEW} FILEID OPERANDS FOR MAPTYPE type 


( Explanation: You specified either too many or too few fileid operands on the 
- MAP command. 


The variable “type” refers to the map type and may be any one of the following: 


e CP 

¢ CMS 

e PVM 

¢ RSCSNET 
e« GCS 

e RSCSV2. 


System Action: Command processing terminates. 


User Response: Correct the operands and reenter the MAP command. — 
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804E REQUIRED OPERAND MISSING FOR ‘keyword’ KEYWORD 


Explanation: An operand value is required following the specified keyword. LA os 
System Action: The subcommand is terminated and DUMPSCAN waits for a ae 
new subcommand to be entered. 
User Response: Enter the HELP subcommand. Or, find the correct subcommand 
syntax. See “Chapter 3. Command Reference” on page 33 and “Chapter 4. 
DUMPSCAN Reference” on page 57 of this document for subcommand syntax. 
Then, correct and reenter the subcommand. 
Commands That Detect Condition: 
VPAIR subcommand of DUMPSCAN 
VREG subcommand of DUMPSCAN 
VSTAT subcommand of DUMPSCAN 
S10E CONFLICT BETWEEN OPERANDS operand1 AND operand2 — 
Explanation: You entered the specified conflicting operands on the command q 
line. 
System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 
User Response: Reenter the subcommand correctly or enter a new subcommand. 
Commands That Detect Condition: 
Subcommand Operand! Operand2 
TRACE HEX FORMAT —_ 
FORMAT HEX See 
CPU ALL 
ALL CPU 
VMDBK LIST any operand 
any operand LIST 
FOR AT 
AT FOR 
- : 
BLOCK ALL PROMPT ‘ 
811E THE OPERAND ‘operand’ MUST BE A HEXADECIMAL NUMBER 


Explanation: An operand that must be a hexadecimal number contained 
nonhexadecimal characters. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Reenter the subcommand correctly or enter a new subcommand. 
Commands That Detect Condition: 


All commands and subcommands 
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812K 
813E 
814E 


( 900K 


Messages 


THE type OPERAND ‘operand’ IS GREATER THAN MAXIMUM VALUE OF 
value 


Explanation: An operand exceeded its maximum permissible value. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. 


User Response: Correct the input and reenter or enter a new subcommand. 
Commands That Detect Condition: 


All commands and subcommands 


THE type OPERAND ‘operand’ MUST BE A DECIMAL NUMBER 


Explanation: In response to a prompt message for selection criteria, you specified 
nondecimal characters for an operand that must be a decimal number. 


System Action: Your response is ignored. You will be reprompted. 


User Response: Reenter the keyword and a valid decimal number. If you want 
to end the prompt, enter a null line. 


Commands That Detect Condition: 
TRACERED 


‘operand’ OPERAND SPECIFIED TWICE 


Explanation: You entered the displayed operand twice while issuing a 
DUMPSCAN subcommand. 


System Action: Subcommand processing is terminated and DUMPSCAN waits 
for you to enter a new subcommand. 


User Response: Reenter the subcommand using the specified operand only once. 
Commands That Detect Condition: 
BLOCK subcommand of DUMPSCAN 


PROCESSING ERROR FROM name, CODE nnn 


Explanation: A nonzero return code was returned from the indicated routine or 
macro “name” and the return code was “nnn”. This indicates an internal proc- 
essing error. 


System Action: Command processing continues, if possible. 
User Response: If the condition continues, notify your service representative. 
Commands That Detect Condition: 


Any command or subcommand 
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S1IOE THE VIRTUAL STORAGE CAPACITY IS EXCEEDED 


SA 


A, 


Explanation: There is not enough virtual storage available for the command or 
subcommand to complete processing. This may be the result of a system a 
problem, such as storage not being properly released, or the user may have 

attempted to use the command in a virtual machine that was not of the required 

virtual size. 


System Action: Subcommand processing is terminated and the dump viewing 
facility waits for a new subcommand. | 


User Response: Verify that the storage size of the virtual machine is large 
enough. If it is not, define a larger size and reIPL. 


Commands That Detect Condition: 


ADDMAP 

DUMPSCAN 

CHAIN subcommand of DUMPSCAN 

VMDBK subcommand of DUMPSCAN — 
MAP i Y 
PRTDUMP 

TRACERED 


9201 THE DISK on IS NOT ACCESSED 
Explanation: The disk containing a requested file was not accessed. 


System Action: Command processing is terminated, or the user is prompted for HPS 
the correct file name. | 


User Response: Verify that the correct disk (filemode) was specified, and that it 
was linked to the system. If it was correct and linked, use the CMS ACCESS 
command to access the disk. If prompted, enter the correct file name, or else 
reissue the command with the correct file name. 


Commands That Detect Condition: 


All commands and subcommands 


930E DISK nn IS READ ONLY ae 
Explanation: You are trying to write toa READ ONLY disk. 
System Action: Command processing is terminated. 
User Response: Reenter TRACERED and specify a different filemode. 


Commands That Detect Condition: 
TRACERED 
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Messages 


ERROR READING FILE filename filetype filemode, CODE nn 


Explanation: An error occurred preventing the dump viewing facility from 
reading the data. FSREAD failed with the CMS return code indicated. 


System Action: Processing continues, if possible. 


User Response: None. 


Commands That Detect Condition: 


Any command or subcommand 


ERROR PRINTING DATA, CODE nn 


Explanation: An error occurred preventing the dump viewing facility from 
printing the requested data. PRINTL failed with the CMS return code indicated. 


System Action: Processing continues, if possible. 


User Response: Refer to the appropriate system publications for the return code 
definition. 


Commands That Detect Condition: 


Any command or subcommand 


ERROR WRITING filename filetype filemode, CODE nnn 


Explanation: An error occurred preventing the dump viewing facility from 
writing the requested data. FSWRITE failed with the CMS return code indicated. 


System Action: Command processing terminates. 


User Response: Refer to the appropriate system publications for the return code 
definitions. | 


Commands That Detect Condition: 


ADDMAP 
DUMPSCAN 
MAP 
PRTDUMP 
TRACERED 
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Messages 


Dump Viewing Facility Message Summary by Message Number mo 


010A ENTER TRACE ENTRY SELECTION CRITERIA, NULL LINE TO END SELECTION, OR vy _ 
| QUIT TO END TRACERED COMMAND 
015A WILL YOU BE MOUNTING ANOTHER TRSAVE TAPE? ENTER YES OR NO 


020E ‘operand!’ AND ‘operand?’ ARE CONFLICTING KEYWORD OPERANDS 

O21E TAPE DEVICE ADDRESS INVALID 

0301 PROCESSING TRSAVE TAPE - VOL SEQ # nn - CREATED mm/dd/yy hh:mm:ss 

0311 END OF TAPE ENCOUNTERED - CURRENTLY nnnnnnnn TRACE ENTRIES FOR- 
MATTED 


0321 WAITING FOR TAPE MOUNT 

040E TIME SELECTION RANGE MAY BE SPECIFIED ONLY ONCE 

O41E A MAXIMUM OF SIXTEEN CPU ADDRESSES MAY BE SPECIFIED 

042E = A MAXIMUM OF SIXTEEN TRACE CODES MAY BE SPECIFIED 

043E A MAXIMUM OF SIXTEEN VMDBK ADDRESSES MAY BE SPECIFIED 

044E A MAXIMUM OF SIXTEEN RDEV NUMBERS MAY BE SPECIFIED 

045E A MAXIMUM OF SIXTEEN VDEV NUMBERS MAY BE SPECIFIED 

046E A MAXIMUM OF SIXTEEN USERIDS MAY BE SPECIFIED 

049E LEADING ZEROS REQUIRED FOR CODE SELECTION VALUE ‘value’ 

050E ‘value’ IS NOT A VALID SELECTION VALUE 

051E THE keyword OPERAND ‘value’ WAS NOT PREVIOUSLY SELECTED 

052E CP SELECTION KEYWORD(S) SPECIFIED FOR GUEST TRACE TABLES - KEYWORD(S) 

| IGNORED 

060E TAPE WAS NOT CREATED BY THE TRSAVE COMMAND 

061E TAPE vdev IS NOT ATTACHED 

062E PERMANENT TAPE I/O ERROR 

0701 NO TRACE ENTRIES FOUND MEETING THE REQUESTED SELECTION CRITERIA a 

0711 ONE OR MORE TRACE ENTRIES MISSING FROM TRSAVE TAPE(S) : . J 

0731 NO TRACE ENTRIES FOUND MEETING THE REQUESTED SELECTION CRITERIA = 
FOR THE CURRENT INPUT TAPE 

074E THE SYSTEM TRACE FILE ‘filename’ WAS NOT FOUND | 

076E THE OPERAND GTRACE IS NOT VALID FOR CP TRACE DATA 

080E DUPLICATE INPUT SYSTEM TRACE FILES WERE SPECIFIED 

081E SYSTEM TRACE FILE spoolid IS INVALID 

082E ERROR {OPENING|READING|CLOSING} SYSTEM TRACE FILE spoolid CODE nn 

083E PROCESSING SYSTEM TRACE FILES spoolid CREATED MM/DD HH:MM::SS 7 

0841 PROCESSING COMPLETE - nnnnnnnn TRACE ENTRIES FORMATTED — 

085E SYSTEM TRACE FILENAME ‘filename’ HAS FILES FROM MORE THAN ONE ORIGI- NY 
NATOR. RE-ENTER COMMAND AND SPECIFY FILENAME WITH SPOOLID. 

086E SYSTEM TRACE FILE spoolid IS CURRENTLY IN USE 

088E THE SYSTEM TRACE FILE SPOOLID ‘spoolid’ WAS NOT FOUND 

- 089E ONLY ONE CP TAPE OR CP SYSTEM TRACE FILE IS ALLOWED 

090E DUPLICATE KEYWORDS WERE SPECIFIED 


0911 ONE OR MORE TRACE ENTRIES MISSING FROM SYSTEM TRACE FILE spoolid 

0921 TIME ZONES ARE DIFFERENT FOR SYSTEM TRACE FILE spoolid 

0931 TIME ZONES ARE DIFFERENT FOR TAPE-VOL SEQ# nn. FILE NOT PROCESSED. 

094E THE STARTING DATE AND TIME MUST BE LESS THAN THE ENDING TIME AND 
DATE 

095E THE SYSTEM TRACE FILE SPOOLID ‘spoolid? WAS NOT FOUND WITHIN FILENAME 
‘filename’ 


096E RE-IPL CMS. TRACERED HAS A SEVERE ERROR 


110E THE FILE NAME ‘filename’ IS NOT VALID 
120A ENTER DUMP FILE NAME IN THE FORM XXXXXXXX, OR IN THE FORM 
XXXXXXXX FILEMODE 
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ENTER THE FILENAME FILETYPE FILEMODE OF THE INPUT type LOAD MAP, A 
NULL LINE, SUBSET OR HX 

ENTER THE FILENAME FILETYPE FILEMODE OF THE OUTPUT type MODULE MAP, 
A NULL LINE, SUBSET OR HX 

ENTER THE MAP TYPE, A NULL LINE, SUBSET OR HX 

ENTER THE FILENAME FILETYPE FILEMODE OF THE ee CMS SEGMENT LOAD 
MAP, OR ENTER SUBSET, NONE OR HX 

THE type FILE filename filetype filemode WAS NOT FOUND 

THE FILE filename filetype filemode ALREADY EXISTS 

THE FILE filename filetype filemode IS NOT A VALID type 

THE DUMP FILE REQUESTED IS NOT A VALID DUMP 

THE type FILE filename filetype filemode IS INCOMPLETE 

PROCESSING FILE xxxxxxxx DUMP filemode 

THE SUMMARY REPORTS HAVE BEEN PRINTED FOR FILE xxxxxxxx DUMP filemode 
THE type SUMMARY REPORT IS NOT COMPLETE; SEE REPORT FOR DETAILS 

DO YOU WANT PRINTING TO CONTINUE? ENTER YES OR NO 

THE FORMATTING ROUTINE ‘routine name’ FOR ‘type’ COULD NOT BE FOUND 

SVC 199 IS CURRENTLY IN USE 

PRINTING FORMATTED STORAGE IS NOT SUPPORTED BY DUMP VIEWING 
FACILITY 

THE ROUTINE ‘routine name’FOR ‘spoolid’? CANNOT BE FOUND 


THE DUMP HAS NO MODULE MAP 

DUMP filename filetype filemode ALREADY HAS A MODULE MAP 

DO YOU WANT TO REPLACE THE PREVIOUS MAP? ENTER YES OR NO 

THE MODULE MAP CANNOT BE APPENDED TO A type DUMP 

THE FILES filename filetype filemode AND filename filetype filemode ARE INCOMPATIBLE 
THE typel MODULE MAP FILE filename filetype filemode DOES NOT MATCH THE type2 
DUMP filename filetype filemode 

THE PVM LOAD MAP filename filetype filemode OVERLAPS A PREVIOUS MAP 

THE MODULE MAP filename filetype filemode HAS BEEN CREATED FROM LOAD MAP 
filename filetype filemode 

THE MAP filename filetype filemode HAS BEEN APPENDED TO DUMP filename 

THE INPUT type LOAD MAP NAME IS filename filetype filemode 

MAP TYPE IS CP | 

THE LOAD MAP filename filetype filemode HAS BEEN APPENDED TO MODULE MAP 
filename filetype filemode 

DYNAMICALLY CREATING MODULE MAP. 

DISK nn IS READ ONLY, DYNAMIC MAP NOT CREATED 

INSUFFICIENT DASD SPACE, DYNAMIC MAP NOT CREATED 

THE MODULE OR ENTRY POINT name WAS NOT IN STORAGE AT THE TIME OF THE 
DUMP 

THE ADDRESS address IS NOT IN A MODULE 

THE MODULE OR ENTRY POINT name WAS NOT FOUND IN THE MODULE MAP 
THE MODULE OR ENTRY POINT name IS LOCATED AT ADDRESS address 


subcommand IS NOT A RECOGNIZED SUBCOMMAND 

READY, DUMP TYPE IS type 

THE subcommand SUBCOMMAND IS NOT VALID FOR type DUMPS 

THE option OPTION IS NOT VALID FOR type DUMPS 

THE ‘operand’ OPERAND IS NOT VALID FOR type DUMPS 

THE IPCS SUBCOMMAND ‘subcommand’ IS NOT SUPPORTED FOR type DUMPS 
BLOCK INITIALIZATION HAS STARTED, PLEASE BE PATIENT 

BLOCK INITALIZATION HAS COMPLETED SUCCESSFULLY 

BLOCK INITALIZATION HAS FAILED 

UNABLE TO PROCESS THE BLOCK SUBCOMMAND 
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4501 © THE BLOCK TABLE ‘tablename’ WAS NOT FOUND 


4Sil THE ‘cbname’ CONTROL BLOCK CANNOT BE FOUND IN ANY BLOCK TABLE —_ 
4521 THE FIELD ‘field name’ WAS NOT FOUND M 


454E UNKNOWN CONTROL BLOCK ID, RE-ENTER BLOCK SUBCOMMAND USING ~~ 
CONTROL BLOCK NAME | 

455A ENTER FIELD NAME(S) TO BE FORMATTED, QUIT TO END SUBCOMMAND OR 
NULL LINE TO END PROMPT 

456I TOO MANY FIELD NAMES SPECIFIED, THE EXTRA NAMES ARE IGNORED 

457K BLOCK SUBCOMMAND NOT SUPPORTED FOR type DUMP 

458E THE CONTROL FILE fname ftype WAS NOT FOUND 

459E CANNOT LOCATE ANY OF THE BLOCK TABLE FILES 


5101 THE & NAME TABLE IS FULL 

511K &name IS NOT IN THE &NAME TABLE 

512] THE &NAME TABLE IS EMPTY 

5201 A LOOP WAS DETECTED IN THE type CHAIN 

5211 CONTROL BLOCK AT address POINTS TO CONTROL BLOCK AT address 7 
522] CONTROL BLOCK #nnnn POINTS TO CONTROL BLOCK #nnnn oN 
$231 nnnn ENTRIES WERE FOUND IN THE CHAIN % 
524] THE FIRST CONTROL BLOCK POINTS TO ITSELF 


5251 CB # nnnn AT address 

5261 THE LAST CONTROL BLOCK POINTS TO THE FIRST 

5271 THE LAST CONTROL BLOCK POINTS TO ITSELF 

5281 CHAIN MAXIMUM OF 4096 CONTROL BLOCKS REACHED 
5291 nnnn ENTRIES - PROCESSING CONTINUES 


5301 THE STRING string WAS NOT FOUND 

540E THE STARTING ADDRESS address MUST BE LESS THAN THE ENDING ADDRESS 

541E | THE STARTING ADDRESS address MUST BE GREATER THAN THE ENDING ADDRESS | 
5431 THE BEGINNING OF THE DUMP WAS REACHED © il 
544E A VALID SCROLLING ADDRESS HAS NOT YET BEEN ESTABLISHED 

545E SCROLLING BEYOND OFFSET offset IS INVALID 

5601 THE CPU ADDRESS cpuaddr IS NOT IN THE DUMP 

5701 VECTOR INFORMATION IS NOT AVAILABLE FOR THIS VIRTUAL MACHINE 

5711 VECTOR INFORMATION IS NOT AVAILABLE FOR THIS CPU 

577E THE STARTING REGISTER IS GREATER THAN THE ENDING REGISTER 

578E THE STARTING ELEMENT IS GREATER THAN THE ENDING ELEMENT 

579E § THE REGISTER OPERAND ‘operand’ IS GREATER THAN number CHARACTERS Fs 
580E THE ELEMENT OPERAND ‘operand’ IS GREATER THAN number CHARACTERS .y 


6001 NO VALID TRACE ENTRIES WERE FOUND FOR CPU ADDRESS cpuaddr 
6011 NO VALID TRACE ENTRY WAS FOUND AT ADDRESS address 


6021 THE TRACE SUMMARY WILL CONTINUE WITHOUT CPU cpuaddr 

6031 THE TRACE ENTRY AT address IS NOT IN THE TRACE TABLE FOR CPU cpuaddr 

6101 THERE IS NO SELECTION CRITERIA IN EFFECT 

611I THE USER ‘userid’ DOES NOT APPEAR IN THE DUMP 

6201 THE VMDBK FOR USER userid DOES NOT EXIST IN THE DUMP 

6211 THERE IS NOT ENOUGH STORAGE IN AN INTERNAL TABLE FOR THE nnn ENTRIES 
FOUND IN THE DUMP 

622E ‘field?’ IS NOT A RECOGNIZED VMDBK FIELD 

6231 DUPLICATE USERIDS WERE FOUND IN THE VMDBK CHAIN 

6241 USERID userid IS A DUPLICATE USERID 

6401 = = THE VIRTUAL type value FOR USER userid DOES NOT EXIST IN THE DUMP 

6411 THE type device DOES NOT EXIST IN THE DUMP 


6421 NO type [FOR USER userid] COULD BE FOUND 
6431 THE type DEVICE BLOCKS FOR DEVICES nnnn TO mmmm ARE NOT AVAILABLE 
6601 THE ENTRY AT address IS NOT WITHIN THE FRAME TABLE 
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6611 THE ENDING ADDRESS OF THE FRAME TABLE IS BEYOND THE DUMP STORAGE 
SIZE OF size 
6701 NO SNAP DATA IS PRESENT 
6901 THE DUMP SYMPTOM RECORD IS MISSING FROM FILE xxxxxxxx DUMP filemode 
7011 THE type ADDRESS address MUST BE ON A boundary BOUNDARY 
7021 THE type ADDRESS address EQUALS OR EXCEEDS THE DUMP STORAGE SIZE OF size 
7031 THE type ADDRESS IS ZERO 
7201 THE type CHAIN IS BROKEN 
7301 THE type PAGE WITH ADDRESS address IS NOT IN THE DUMP 
7351 THE DATA IN PAGE address HAS CHANGED SINCE THE SOFT ABEND OCCURRED 
7401 THE PREFIX PAGE COULD NOT BE FOUND 
TAI THE PREFIX PAGE FOR CPU cpuaddr IS NOT AVAILABLE 
7501 DUMPID DATA WAS NOT PROVIDED 
8001 THE EXTRA OPERAND ‘operand’ IS IGNORED 
SO1E THE OPERAND ‘operand’ IS NOT VALID 
( 802E THE REQUIRED operand OPERAND IS MISSING | 
| 803E TOO {MANY|FEW} FILEID OPERANDS FOR MAPTYPE type 


804E REQUIRED OPERAND MISSING FOR ‘keyword’ KEYWORD 

810E CONFLICT BETWEEN OPERANDS operand! AND operand2 

811E THE OPERAND ‘operand’ MUST BE A HEXADECIMAL NUMBER 

S12E THE type OPERAND ‘operand’ IS GREATER THAN MAXIMUM VALUE OF value 
813E TIME type OPERAND ‘operand’ MUST BE A DECIMAL NUMBER 

814E ‘operand’ OPERAND SPECIFIED TWICE | 


ae 900E PROCESSING ERROR FROM name, CODE nnn 
( | 910E THE VIRTUAL STORAGE CAPACITY IS EXCEEDED 
os 9201 THE DISK nn IS NOT ACCESSED 
930E DISK nn IS READ ONLY | 
950E ERROR READING FILE filename filetype filemode, CODE nn 
960E ERROR PRINTING DATA, CODE nn 
970E ERROR WRITING filename filetype filemode, CODE nnn 
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Appendix A. RIOBLOK Field Names 


Following 1s a list of items that appear on the screen as a result of the RIOBLOK 
subcommand. Each item 1s listed with the corresponding field name found in the 
dump. 


There are three types of information that may be included on the screen: 


¢ General device information—information for each device in the dump. 


e Device-dependent information—additional information about spooling, direct 
access storage devices (DASD), and display devices. 


¢ Active IORBK information—information about a device that had active I/O at 
the time the dump was taken. This information is taken from the I/O request 
and response block if it is available. 


( The general real device information displayed 1s: 
Display Field Dump Field Name 
REAL DEVICE OR LOGICAL DEVICE RDEVDEV 
SUBCHANNEL RDEVSUB 
RDEV ADDRESS 
CLASS (device)* RDEVCLAS 
- TYPE (device)* RDEVTYPE 
( / USER VMDBK ADDR RDEVUSER 
ks, USER VMDBK USERID VMDUSER 
LOCK OWNER VMDBK ADDR RDEVLOWN 
LOCK OWNER VMDBK USERID VMDUSER 
ACTIVE IORBK ADDR RDEVAIOR 
INTERVENTION REQ'D IORBK ADDR RDEVNXTW 
NEXT IMMEDIATE IORBK ADDR RDEVNXTI 
FEATURE RDEVFEAT 
MODEL RDEVMODL 
DEDICATED VDEV ADDR RDEVVDEV 
( | WAIT DEVICE CPEBK ADDR RDEVWTDV 
| WAITING TASK QUEUE RDEVTSKQ 
RDEVAFLG (allocation flag) RDEVAFLG 


RDEVDFLG (device dependent status) RDEVDFLG 
RDEVRFLG (error recovery control 

flag) RDEVRFLG 
RDEVSTAT (operation status flag) RDEVSTAT 


*This field may contain a descriptive name in addition to the 
hexadecimal content from the dump. 
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The following table lists the descriptive name for each device class along with the 


HCPRDEV control block bit that corresponds to it. If the device class is not recog- ff : 
nized, only the hexadecimal data contained in the field is displayed. __ _ eos? 
Text Bit Name Explanation 


DISPLAY CLASGRAF Graphic display device 


SPOOL CLASPOOL Unit record spooling device 
TAPE CLASTAPE Magnetic tape device } 
DASD _ CLASDASD Direct access storage device 


SPECIAL CLASSPEC Special device 


The device-dependent information displayed for: 


A Spooling Device 


Display Field Dump Field Name . cr 

RSPBK ADDR RDEVRSP 

ACTIVE SPFBK ADDR RSPASFB 

CURRENT SPABK ADDR RSPASFAL 

RSPFLAG (device control flag) RSPFLAG 

RELATIVE SPDBK NUMBER RSPADNUM 

SPOOL CLASSES RSPCLASS 

ACTIVE FILE ID RSPSPID 

SILBK ADDR | RSPIL - 

i 

Note: If the page containing the RSPBK is not in the dump file, “RSPBK INFOR- ’ J 
MATION IS NOT AVAILABLE?” will be displayed in place of the above ae 
information. 

DASD Devices 

Display Field Dump Field Name 

SYSTEM CPVOL ENTRY RDEVVOL 

VOLUME SERIAL ID | RDEVSER — 

NEXT LOWER IORBK ADDR RDEVNXTL S r, 

NEXT HIGHER IORBK ADDR RDEVNXTH = 


For all display devices 


Display Field Dump Field Name 
COMBK ADDR RDEVCON 
TRQBK ADDR RDEVTRQ: 


RDEVSFLG (Screen control flags) RDEVSFLG 
RDEVTFLG (Terminal operation 
control flags) RDEVTFLG 
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The active IORBK information is displayed for: 


Interruption Response Block (IRB) 


Display Field Dump Field Name 
FCTL (Function control flag) IRBFCTL 

ACTL (Activity control flag) IRBACTL 

DVST (Device status flag) IRBDVST 

SCST (Subchannel status flag) IRBSCST 

COUNT (Unexpired count in CCW) IRBCNT 

CCW ADDR IRBCCWA 


Operations Request Block (ORB) 


Display Field Dump Field Name 
( KEY (Key of I/0 transfer) ORBKEY 
. FPI (Format, prefetch, and 
response flag) ORBFPI 
LPM (Logical path mask) ORBLPM 
CPA (Channel program address) ORBCPA 
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Appendix B. VIOBLOK Field Names 


Following is a list of items that appear on the screen as a result of the VIOBLOK 
subcommand. Each item is listed with the corresponding field name found in the 
dump. : 


There are three types of information that may be included on the screen: 


¢« General Device information—information for each device in the dump. 


© Device-dependent information—additional information about spooling, direct 
access storage devices (DASD), and channel-to-channel adapter (CTCA) devices. 


e Active IORBK information—information about a device that had active I/O at 
the time the dump was taken. This information is taken from the I/O request 
and response block if it is available. 


( The general virtual device information displayed is: 
Display Field Dump Field Name 
VIRTUAL DEVICE VDEVDEV 
SUBCHANNEL VDEVSUB 
VDEV ADDRESS | | 
USER VMDBK USERID VMDUSER 
CLASS (device) * VDEVCLAS 

ate TYPE (device)* VDEVTYPE 

( USER VMDBK ADDR VDEVUSER 
USER MODE VMDMODE, VMDSTYPE 
LOCK OWNER VMDBK ADDR VDEVLOWN 
ACTIVE IORBK ADDR VDEVAIOR 
PENDING INTERRUPT IORBK ADDR VDEVPIOR 
START/RESUME PENDING IORBK ADDR VDEVNIOR 
SENSE IORBK ADDR VDEVSIOR 
REAL DEVICE NUMBER VDEVRDEV 
WAITING TASK QUEUE VDEVTSKQ 

wom, COMPLETION TASK QUEUE VDEVENDQ 

( VDEVAFLG (allocation flag) VDEVAFLG 


VDEVDFLG (device dependent status) VDEVDFLG 
VDEVSTAT (operation status flag) VDEVSTAT 
VDEVWAIT (wait status control) VDEVWAIT 


*This field may contain a descriptive name in addition to the 
hexadecimal content from the dump. 
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_ The following table lists the descriptive name for each device class along with the 


HCPVDEV control block bit that corresponds to it. If the device class is not recog- aa 
nized, only the hexadecimal data contained in the field is displayed. . | \ 7 
Text - Bit Name Explanation 


DISPLAY CLASGRAF Graphic display device 


SPOOL CLASPOOL Unit record spooling device 
TAPE CLASTAPE Magnetic tape device 
DASD CLASDASD Direct access storage device 


SPECIAL CLASSPEC Special device 
The device-dependent information displayed for: 


A Spooling Device 


Display Field Dump Field Name 

VDSBK ADDR VDEVVDS es 
VPXBK VDEVVPX Sw 
ACTIVE SPABK ADDR VSPSPA 

CURRENT SPFBK ADDR VSPSPF 

VSPBK ADDR VDEVVSP 


Note: If the page containing the VDSBK is not in the dump file, “VWDSBK INFOR- 
MATION IS NOT AVAILABLE” will be displayed in place of the above 


information. 
DASD Devices e *% 
Display Field Dump Field Name ‘A 
MINIDISK STARTING CYLINDER VDEVSCYL 
MINIDISK ENDING CYLINDER VDEVECYL 
MDISK ADDRESS VDEVLINK 


For all Channel-to-Channel Adapters (CTCA) 


Display Field Dump Field Name 

aia x 
X-SIDE CACBK ADDR VDEVCTCA —_ 
X-SIDE COMMAND CODE CACXCMND _ 
X-SIDE LOCKWORD CACXLOCK 
Y-SIDE CACBK ADDR CACXYCAC 
Y-SIDE COMMAND CODE CACYCMND 
Y-SIDE VDEV ADDR CACYVDEV 


Note: If the CTCA does not have a CACBK, only the line with the X-Side CACBK 
address will be shown containing a value of zero. If the page containing the 
X-Side CACBK is not available, “CACBK INFORMATION IS NOT 
AVAILABLE” will appear in place of the above information. 
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The active IORBK information displayed for: 


Interruption Response Block (IRB) 
Display Field 


IRBFCTL (Function control flag) 
IRBACTL (Activity control flag) 
IRBDVST (Device status flag) 
IRBSCST (Subchannel status flag) 
IRBCNT (Unexpired count in CCW) 
IRBCCWA (CCW address) 


Operations Request Block (ORB) 
Display Field 
KEY (Key of I/0 transfer) 


FPI (Format, prefetch, and 
response flag) 


LPM (Logical path mask) 


CPA (Channel program address) 


I/O Request and Response Block 
Display Field 
KEY 


FPI 
LPM 


Dump Field Name 


TIRBFCTL 
IRBACTL 
IRBDVST 
TRBSCST 
IRBCNT 

TRBCCWA 


Dump Field Name 
ORBKEY 


ORBFPI 
ORBLPM 
ORBCPA 


Dump Field Name 


TORUKEY 
IORUFPI 
TORULPM 


Note: If the device does not have a currently active IORBK, “NO ACTIVE 
IORBK” will appear in place of the above information. Also, if the page con- 
taining the active IORBK is not in the dump file, “ACTIVE IORBK 
INFORMATION IS NOT AVAILABLE” will appear in place of the above 


information. 
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( Appendix C. Frame Status 


The following charts map the bit setting in each of the four types of frame status for 
the FRAMETBL PRTDUMP summary. In each type, only the first bit found to be 
set will be summarized, and if none are applicable, that summary field will be left 
blank. Also, the bits are tested in the order they are shown on the chart. 


Queue-Oriented Status 


Description 
AVAILABLE On available queue — FRMAVAIL is set 
a USER-OWNED On a user owned list — FRMOWNED is set 
( CP-LOCK-CMD Locked by CP LOCK command — FRMCPLOK is set 
STOR-LOCKED Locked in real storage — FRMLOCKD is set 


Figure 86. Output Text for Queue-Oriented Status 


Frame Serialization Status 


TRANS Being translated — FRMTRANS 1s set 

STEAL Being stolen — FRMSTEAL is set 

RELSE Being released — FRMRELSE 1s set 
( Ba Figure 87. Output Text for Frame Serialization Status 


Frame Information Status 


Description 


SHARED Shared storage frame — FRMSHARE 1s set 


RCP-PAGE User RCP page — FRMRCP is set 


Figure 88. Output Text for Frame Information Status 
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Miscellaneous Status 


IN-ERROR Frame is in error — FRMERROR is set. 

LAST-TRANS | Last translated, frame cannot be stolen — FRMLTRCT is set. 
RECLAIM Being reclaimed — FRMRECLM is set. 

REFRESH Refresh required — FRMFRSH is set. 


Frame is being manipulated and must not be given out to. 
anyone by the available list manager — FRMNOGIV is set. 
Read only frame — FRMRONLY is set. 


NO-GIVE 


READ-ONLY 


Figure 89. Output Text for Miscellaneous Status 
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Appendix D. Dumping the Abend Dump to Tape 


The following procedure outlines the commands to dump the VM/XA System 
Product to tape to send to IBM: 


1. Use the CMS DUMPLOAD command to place the dump on your A-disk. 


2. Rename the dump filename with the CMS RENAME command. For example, 
when you issue the DUMPLOAD command, the dump file may be named 
PRBO0001 DUMP A. You may rename this file. For example: 


RENAME PRBOQOQO1 DUMP A CPDUMPO1 DUMP A 


3. Finally, copy the dump to tape using the CMS TAPE DUMP command. The 
format for this command is: 


TAPE DUMP filename filetype filemode 


ron Note: For further information about CMS Commands, refer to the VM/XA SP 
( CMS Command Reference. | 


t 
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C Appendix E. The Dump Viewing Facility HCSTBL Table 


How the Dump Viewing Facility Uses the HCSTBL Table 
The VM/XA SP dump viewing facility has duplicated the VM/SP IPCS (Interactive 
Problem Control System) capability of using the component/program product- 
supplied formatting routines to view or print the data particular to the respective 
component/program product dump. To do this, the dump viewing facility has con- 
structed a table, HCSTBL, which is similar to the IPCS supported product table. 


The ability to use these formatting routines to view the VM dump is made possible 
by the dump viewing facility’s use of the HCSTBL table. The HCSTBL table has 
fields associated with each supported component/program product dump type. For 
each particular dump type there is a field that contains the formatting routine lead 
module name for DUMPSCAN and another field with the name for PRTDUMP. 
a The interface from the dump viewing facility to the formatting routines 1s similar to 
( the interface provided by IPCS for the same purpose. 


In addition to the formatting routine information, the HCSTBL also holds vital data 
for the BLOCK subcommand of DUMPSCAN. This data is contained in one of the 
HCSTBL fields. The field contains the 4-character identification for the control file 
that the BLOCK subcommand uses for each of the particular dump types. For 
instance, the block control file that is shipped with the dump viewing facility is for 
use with CP dumps. Its filename is HCS$CP/; the 4-character identification in this 
case is ‘CPI ’. 


( | The HCSTBL table is contained within a file named HCSTBL ASSEMBLE and is 
shipped with the dump viewing facility. 


Note: The dump viewing facility uses a similar format for its HCSTBL table as the 
table used in VM/XA SP IPCS. This does not necessarily mean that the dump 
viewing facility uses all the fields in the exact manner of IPCS. 


The Format of the HCSTBL Table 
The table is organized by dump types supported by the dump viewing facility as 


( = follows: 


« CP 

« CMS 

¢ RSCSNET 

e RSCSV2 

e PVM 

° GCS. 
For each dump type there are seven fields of data relating to that particular dump 
type as follows: 


1. ID field: The character identification that was specified at the time of the dump 
(it can be up to 8 characters). 


2. IDLEN field: The length of the ID minus one 


3. EXT field: Not supported for the dump viewing facility 
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4. DMP field: The name of the lead DUMPSCAN formatting routine for the 

_ dump type 7 7 | | 

5. PRT field: The name of the lead PRTDUMP formatting routine for the dump 
type | 

6. MAP field: Not supported for the dump viewing facility 

7. TYPE field: The block control file 4-character identification for the dump type. 


Note: Supported dump types whose data fields contain “00” indicate that the dump 
viewing facility will ignore that field, that is, the PRT field for the PYM dump type 
is “QO” and therefore the dump viewing facility assumes no PRTDUMP formatting 
routine specific to a PVM dump type exists. | 


~ 


The HCSTBL Table (part of the HCSTBL ASSEMBLE file) 


Note: Modification of the CPDMP and CPPRT fields is not supported. The dump 


viewing facility uses the its own DUMPSCAN and PRTDUMP function to format 
CP dumps; no exit can be taken. 
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re ” 


KEKREREKKEEKRKRERRRRREKRE 


CPID DC 
CPIDLEN DC 
CPEXT DC 
CPDMP DC 
CPPRT DC 
CPMAP DC 
CPTYPE DC 


ENTRYEND EQU 


KREEKEKEKEREREEEREREER 
BRKRKEKKKRERKEKRERERERERE 


CMSID DC 
CMSIDLEN DC 
CMSEXT DC 
CMSDMP =-—~ODC 
CMSPRT DC 
CMSMAP DC 
CMSTYPE DC 


KKEEKEEKEKREERERKREREKRER 


CL8‘CP' 
Fiy'! 


XL8'00' 


XL8'00' 


XL8'00' 


XL8‘00' 
CL4'CP1 ' 


* 


CL8'CMS' 
FI?! 
CL8'DMMCMS' 
CL8'DMMDCM' 
XL8'00' 


CL8*CMSIPCS' 


CL4'°CMS ' 


START OF 'CP' ENTRY KKKKKEKKEKKEKEKEKKEKRREKREEKEERE 


CP ID 

LENGTH OF CP ID MINUS 1 
CP EXTRACT ROUTINE 

CP DUMPSCAN ROUTINE 

NO CP PRTDUMP ROUTINE 
CP MAP DEFAULT NAME 
BLOCK ID FOR CP DUMPS 


END OF 'CP' ENTRY KKKKKKKKKREKKEREREKEREKERE 


START OF 'CMS' ENTRY KEKKKEKKRKRK KERR KREERERERK 


CMS ID 

LENGTH OF CMS ID MINUS 1 
CMS EXTRACT ROUTINE 

CMS DUMPSCAN ROUTINE 

NO CMS PRTDUMP ROUTINE 
CMS MAP DEFAULT NAME 
BLOCK ID FOR CMS DUMPS 


END OF 'CMS' ENTRY KKKKKKKKKEKEKEKREKEKKERKEKKEKREE 


KKEKKEKERERKEKRERERREESK START OF 'RSCSNET' ENTRY BKKKKEEKREREREKRRERRREREERERE 


RSCSID = DC 
RSCSIDLN DC 
RSCSEXT DC 
RSCSDMP DC 
RSCSPRT DC 
RSCSMAP DC 
RSCSTYPE DC 


KKKEKEKRKEKEERKREKKREREREEKE 


CL8'RSCSNET' 
F'6! 
CL8*DMTZEX' 
CL8'DMTZDS' 
XL8‘Q0' 


CL8*RSCSIPCS ' 


CL4'RSCS' 


RSCSNET ID 

LENGTH OF RSCSNET ID MINUS 1 
RSCSNET EXTRACT ROUTINE 
RSCSNET DUMPSCAN ROUTINE 

NO RSCSNET PRIDUMP ROUTINE 
RSCSNET MAP DEFAULT NAME 
BLOCK ID FOR RSCSNET DUMPS 


END OF 'RSCSNET! ENTRY  **** 4x4 RRAKKARKKRKEEK ER 


KRKEKEKKKRERERREKRRRERERE START OF 'RSCSV2' ENTRY KEKKKKKKRKEKKEKRREREREKEKE 


RSCSV2ID DC 
RSCSV2LN DC 
RSCSV2EX DC 
RSCSV2DM DC 
RSCSV2PR DC 
RSCSV2MA DC 
GCSRTYPE DC 


RKEEKEREKRKREKRRKEREREREREE 


KERKERERRERERERRERERE 


REEKEKRKERERERERRREEERE 


KREKEKRERERERREREREEE 


PVMID DC 
PVMIDLEN DC 
PVMEXT DC 
PVMDMP DC 
PVMPRT DC 
PVMMAP DC 
PVMTYPE DC 
GCSID DC 
GCSIDLEN DC 
GCSEXT DC 
GCSDMP = DC 
GCSPRT DC 
GCSMAP DC 
GCSTYPE DC 


KKREKRERERERRREREKREERE 


CL8'RSCSV2' 
ae 

CL8'CSITEX' 
CL8'CSIIDS' 
CL8'CSITPR' 


CL8°GCSIPCS' 


CL4'GCRS' 


CL8'PVM' 
be 
CL8'DVMZEX’ 
CL8°DVMZDS" 
XL8'00' 


CL8*PVMIPCS' 


CL4°PVM ' 


CL8'GCS' 
er 
CL8'CSTIEX' 
CL8'CSTIDS' 
CL8'CSTIPR' 


CL8'GCSIPCS ' 


CL4'GCS ' 
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RSCSV2_ ID 

LENGTH OF RSCSV2 ID MINUS 1 
RSCSV2 EXTRACTION ROUTINE 
RSCSV2 DUMPSCAN ROUTINE 
RSCSV2 PRTDUMP ROUTINE 
RSCSV2 MAP DEFAULT NAME 
BLOCK ID FOR RSCSV2 DUMPS 


FND OF 'RSCSV2' ENTRY KKKKKKKEKEKKEKRKREKEREREKKEEE 
START OF 'PVM' ENTRY KKKKKKKKKKEKKKEKKKRKKKKKEEK 


PVM ID 

LENGTH OF PVM ID MINUS 1 
PVM EXTRACT ROUTINE 

PVM DUMPSCAN ROUTINE 

NO PVM PRTDUMP ROUTINE 
PVM MAP DEFAULT NAME 
BLOCK ID FOR PVM DUMPS 


END OF 'PVM' ENTRY KRKKKEKKEKREKERERERERKEKEREEE 


START OF 'GCS' ENTRY KAKKKKKKKEKKEERERERKEERERERE 


GCS ID 

LENGTH OF GCS ID MINUS 1 
GCS EXTRACTION ROUTINE 
GCS DUMPSCAN ROUTINE 

GCS PRTDUMP ROUTINE 

GCS MAP DEFAULT NAME 
BLOCK ID FOR GCS DUMPS 


FND OF 'GCS' ENTRY KKKKKKKKKKKEKEKERERKEREE 


Modifying the HCSTBL Table 3 | 
In order to change the HCSTBL table, you need to do the following: 


1. Place the HCSTBL ASSEMBLE file on your A disk or other writable disk. 


2. Change the data in a particular fields, but do not change the format or order of 
the fields. ; 


3. Reassemble the HCSTBL ASSEMBLE file. 
4. Place the HCSTBL TEXT file on your A disk. 
5. Regenerate the DUMPSCAN and PRTDUMP modules. 
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Appendix F. Dump Viewing Facility SVC 199 Services 


The dump viewing facility uses the VM/SP Interactive Problem Control System 
(IPCS) SVC 199 type of communication facility. This facility provides the interface 
between the dump viewing facility and the IPCS formatting routines used to support: 


¢ Component/program product unique subcommands for DUMPSCAN 
e Formatting routines for PRTDUMP. 


The SVC services may be used by any code written to change the formatting routines 
to enable interaction with the dump viewing facility. 


There are thirteen codes associated with SVC 199 under IPCS. However, not all are 
supported by the dump viewing facility. 


¢ Code = 10: Not supported by the dump viewing facility 


( | ¢ Code = 20: Not supported by the dump viewing facility 
. ¢ Code = 30: Request a work buffer 
PLIST DS OF 
DC AL4(*-*) ADDRESS OF BUFFER RETURNED TO CALLER 
DC =H'30' CODE FIELD 
DC H'O' NUMBER OF BUFFERS REQUESTED 


Note: The caller needs a work buffer. Up to six 4Kb buffers may be requested. 
| The request is denied if all space asked for cannot be provided. Buffers are on 
( page boundaries and are contiguous. | 


Return codes are: 


R15=0 ALL OK 
=4 INSUFFICIENT STORAGE © 
=8 INVALID REQUEST 


¢ Code = 31: Free a work buffer 


PLIST DS OF 
DC AL4(*-*) ADDRESS OF BUFFER(S) TO BE RETURNED 
( “ DC H'31' CODE FIELD 
DC H'O! NUMBER OF 4K BUFFERS TO BE RETURNED 


Frees storage previously obtained with SVC subcode 30. 


Return codes are: 


R15=0 ALL OK 
=4 ADDRESS INVALID 
=8 INVALID REQUEST 


¢ Code = 40: Request data from an address 


PLIST DS OF 
DC AL4(*-*) ADDRESS OF DATA WANTED 
DC =H'40' CODE FIELD | 
DC =—H'0' NUMBER OF BYTES READ CONTIGUOUS TO 


THE ADDRESS REQUESTED AND THE END OF 
OF A 12K BUFFER. 

DC AL4(*-*) ADDRESS OF 12K BUFFER RETURNED TO 
CALLER THAT CONTAINS THE ADDRESS OF 
THE DESIRED DATA 
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The address of the data requested is the first entry in the buffer returned. The 
buffer will vary in length if the next page of the dump was not dumped to the 
page in which the address requested was found. The last halfword of the PLIST . 
contains the total number of consecutive bytes (a maximum of 12K bytes). 


Return codes are: 


R15=0 ALL OK 
=4 PAGE NOT IN DUMP 
=100 READ ERROR 


Notes: 


1. The next subcode call (40 or 41) will overlay the buffer returned we the pre- 
vious invocation of subcode 40 or 41. 


2. When the requested address exceeds dump storage size, R15 is set to 4 and 
the address of the 12K buffer returned is set to X'QOOQOQO0FF'. 


¢ Code = 41: Request data from an address 


PLIST DS OF 

DC AL4(*-*) ADDRESS OF DATA WANTED 

DC =H 41° CODE FIELD 

DC =H'0' NUMBER OF USABLE BYTES RETURNED TO 

— USER. THIS COUNT WILL VARY. 

DC AL4(*-*) ADDRESS OF BUFFER RETURNED TO 
CALLER CONTAINING THE ADDRESS OF 
THE DESIRED DATA. THE ADDRESS 
REQUESTED WILL BE ROUNDED DOWN TO 
A PAGE BOUNDARY. 


The address in the buffer will point to the beginning of the page containing the 
address of the requested data. The preceding page and the following page may 
also be present. The purpose is to provide the page before and the page after 
the requested page. The user must index into the page for his address or use 
SVC 199 code 40. The last halfword of PLIST will contain the total number of 
bytes (a maximum of 12K bytes). 


Return codes are: 


R15=0 ALL OK 
=1 PRECEDING PAGE NOT PRESENT — ye OS 
=2 FOLLOWING PAGE NOT PRESENT \ 
=3 PRECEDING AND FOLLOWING PAGES NOT PRESENT 
=4 PAGE NOT IN DUMP 
=100 READ ERROR 


Notes: 


1. The next subcode call (40 or 41) will overlay the buffer returned by the pre- 
vious invocation of subcode 40 or 41. 


2. When the requested address exceeds dump storage size, R15 is set to 4 and 
the address of the 12Kb buffer returned is set to X'OOO000FF'’. 


¢ Code = 50: Not supported by the dump viewing facility 
¢ Code = 60: Request PRTDUMP to print a buffer that has been translated 


PLIST DS OF | 
~ DC AL4(*-*) ADDRESS OF BUFFER TO BE PRINTED 
DC H'60' CODE FIELD 
~ DC H'0! NUMBER OF CHARACTER LINES 
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7 The buffer contains translated data with a fixed length of 133 characters, 
( | including prefixed print control code. 


Return codes are: 


R15=0 ALL OK 
=4 NUMBER OF LINES = 0 
=500 PRINT FAILURE 


¢ Code = 70: Request PRTDUMP to print the registers and PSWs and the 
appended load map. 


PLIST DS OF 
DC AL4(*-*) RESERVED 
DC H'70' CODE FIELD 


Return codes are: 


R15=0 ALL OK 
7 =100 READ ERROR 
{ : =500 PRINT FAILURE 


Note: When the map is not appended, register 15 equals zero and the dump 
viewing facility message 300I is issued. 


¢ Code = 71: Request to format and print the appended load map. 


PLIST DS OF 
DC AL4(*-*) RESERVED 
DC =H'/1' CODE FIELD 


Return codes are: 


( R15=0 ALL OK 
i =100 READ ERROR 
=500 PRINT FAILURE 


Note: When the map is not appended, register 15 equals zero and the dump 
viewing facility message 300I is issued. 


¢ Code = 80: Not supported by the dump viewing facility. 


¢ Code = 90: Return to user a module and an entry point name when given an 


ore address. 

( PLIST DS OF 
DC AL4(*-*) ADDRESS OF MODULE OR ENTRY NAME 
DC H'90' CODE FIELD 
DC H RESERVED 
DC 8 6CL8' ENTRY NAME RETURNED TO CALLER 
DC AL4(*-*) ENTRY ADDRESS TO CALLER 
DC CL8' ! MODULE NAME TO CALLER 


DC AL4(*-*) MODULE ADDRESS TO CALLER 
Return codes are: 


R15=0 ALL OK 
=2 MAP NOT PRESENT 
=4 ADDRESS NOT IN MAP 
=100 READ ERROR 


¢ Code = 91: Return to caller an entry or module name address when given a 
name. 
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PLIST DS OF | | a 
DC AL4(*-*) ADDRESS RETURNED TO CALLER 
DC -H'91' CODE FIELD 
DC  CL8'NAME' NAME FIELD 


The address is returned to caller. 


Return codes are: 


R15=0 ALL OK ADDRESS RETURNED 
= MAP NOT PRESENT 
= NAME NOT FOUND IN MAP 
=100 READ ERROR | 
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(Appendix G. Table of Publications for IPCS DUMPSCAN 
= Subcommands 


The following table shows the supported dump types that can have IPCS 
DUMPSCAN subcommands issued against them and where you can find more 
information as how to use them: 


VM Dump Type 


CMS 
GCS 
VM 


RSCSNET 
( 7 RSCSV2 
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Appendix H. IPCS DUMPSCAN Subcommands for CMS 
Dumps | 


The following IPCS DUMPSCAN subcommands are supported by the dump 
viewing facility for CMS dumps. 


Note: The IPCS DUMPSCAN subcommand USERMAP is not supported. 
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CMSPOINT Subcommand | 


Use the CMSPOINT subcommand to display the formatted contents of 17 pointers f° 
from CMS NUCON. a 


The format of the CMSPOINT subcommand is as follows: 


| CMSPoint | | | 7 | 


Usage Notes: None. 


Responses: 


LASTCMND= (last command executed) 
PREVCMND= (previous command executed) 
LASTEXEC= (last EXEC executed) 
PREVEXEC= (previous EXEC executed) 
CURRSAVE= (address of current system svc joe, 
Save area) 


FREELOWE= (address of low extent of system 


storage) 

MAINHIGH= (address of high extent of user 
| storage) = 3 

FRDSECT = (address of free storage chain used 

by DMSFRE) 
PGMSECT = (address of program interrupt 

routine) oN 
IOSECT = (address of 1/0 interrupt routine) —_ 
EXTSECT = (address of external interrupt 


routine) 
ADTSECT = (address of active disk table) 


DEVTAB = (address of CMS device table) 

DIOSECT = (address of disk I/0 control) 

SVCSECT = (address of svc handler control block | 
used by DMSITS) ee 

TAXEADDR= (address of terminal attention — 
interrupt exit) SA 


ALDRTBLS= (address of loader tables) 


Error Messages: 


DMMDCC7081 PAGE ‘page' NOT FOUND IN DUMP 
DMMDCM863E INVALID OPERAND - operand 
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Sample Output: 


( | This is an example of the output of the CMSPOINT subcommand. 


LASTCMND= CP 
PREVCMND= LIST 
LASTEXEC= PF 
PREVEXEC= PROFILE 
CURRSAVE= 0000C748 
FREELOWE= 000£8000 
MAINHIGH= 0002B500 
FRDSECT = 00002F60 
PGMSECT = 00002600 
IOSECT = 00002570 
EXTSECT = 00002440 
ADTSECT = 000015FO 
. DEVTAB = 00001390 
( : DIOSECT = 90002940 
a SVCSECT = 000026A0 
TAXEADDR= 00000000 
ALDRTBLS= 00100000 


Figure 90. Output of the CMSPOINT Subcommand 
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DeSrenae Subcommand 


Use the DOSPOINT subcommand to display the formatted contents of five pointers 
used by DOS simulation. 


The format of the DOSPoint subcommand is as follows: 


Usage Notes: 


If the DOSPOINT subcommand is invoked and DOS simulation is not in effect, an 
error message 1s displayed in addition to the formatted display. 


Responses: 

BGCOM = (address of background communications 
area) 

SYSCOM = (address of systems communication 
area) 

LTASAVE= (address of logical transient save 
area) 

ACBLIST= (address of acb list built by 
open/close) 

DOSSECT= (address of first DOSCB control 
block) 


Error Messages: 


DMMDCD7281 DOS SIMULATION NOT IN EFFECT 
DMMDCD708I Page 'page' NOT FOUND IN DUMP 
DMMDCM863E INVALID OPERAND - operand 


Sample Output: 


DMMDCD7281 DOS SIMULATION NOT IN EFFECT 
BGCOM = Q0000DB8 
SYSCOM = QOQ0OCAD 


LTASAVE= 00001180 
ACBLIST= 00000000 
| DOSSECT= 00000000 
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Use the OSPOINT subcommand to display the formatted contents of three pointers 
used in OS simulation. 


The format of the OSPoint subcommand is as follows: 


Usage Notes: None. 


Responses: 
CVTSECT 


(address of simulated communications 
vector table) 

FCBSECT = (address of first file control block) 
OPSECT (address of reading and writing 
parameter list) 


Error Messages 


DMMDCM863E INVALID OPERAND - OPERAND | 
DMMDCO708I PAGE 'page' NOT FOUND IN DUMP 


Sample Output: 


The following is an example of output of the OSPOINT subcommand. 


CVTSECT 


QO000DB8 
00000000 
Q0003BA0 


FCBSECT 
OPSECT 
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C Appendix I. IPCS DUMPSCAN Subcommands for GCS Dumps 


The following IPCS DUMPSCAN subcommands are supported by the dump 
viewing facility for GCS dumps. 
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IUCV Subcommand | 


Use the IUCV subcommand to display all entries in the [UCV path table. The foo 
IUCV path table contains information about all the IUCV paths in this virtual a, 
machine. | 


The format of the IUCV subcommand is as follows: 
Usage Notes: None. 


Responses: 


Displays for each path: 
¢ Owner's id block address 
¢ Exit address 
¢ User word 
e Task control block address 


e Path status. 


Error Messages: 


CSIITIU31S Insufficient free storage is available 

CSITIU503I No IUCV PATH table 3 eo *% 
CSIITIU504I Page ‘nnnnnnnn' not found in dump \ Z 
CSTIIU542I IUCV anchor block ptr is zero. Can't find IUCV path table | 
CSIIIU544I IUCV PATH table ptr is zero 


Sample Output: 


USER-ID-BLOCK EXIT-ADDR USER-WORD TASK-BLOCK PATH-STATUS 


HHHHHH HHHHHH HHHHHHHH = HHHHHH HHHH 
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TACtive Subcommand | 
Use the TACtive subcommand to display the task’s active program list. 


The format of the TACtive subcommand is as follows: 


TACtive [ taskid ALL ] 


Where: 


taskid 
identifies the task you want information about. The format is nnnn. 


ALL 
requests information for all tasks. ALL is the default. 


Usage Notes: None. 


( Responses: 


Displays a chart containing the task ID, the address of the task control block, and 
the task completion code. A state block is a control block that contains information 
about an active program. There are three types of state blocks: 


e Link blocks represent programs that have been invoked via the LINK, SYNCH, 
XCTL, or ATTACH macros, or the OSRUN command. 


e SVC blocks represent calls to the SVC interrupt handler. 

( a e Asynchronous exit blocks exist for asynchronous exits scheduled for this task. 
For every state block on the task’s active program list, this subcommand also dis- 
plays: 

¢ The address of the state block 
e The type of state block (link block, SVC block, or asynchronous exit block) 
e The name and entry-point address of the program that the block represents 


( ¢ The register contents associated with the state block. 


Error Messages: 


CSIIALO31S Insufficient free storage is available 

CSIIAL504I Page ‘nnnnnnnn' not found in dump 

CSITAL505I TASKID 'xxxxxxxx' invalid 

CSITAL545I NUCON extension pointer is zero. Can't find state block 
CSIIAL546I Task block PRT is zero. Can't find state block | 


CSIIAL5471I State block PRT is zero 
CSIIAL548I Taskid table PRT is zero. Can't find state block 
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Sample Output: 


TASK BLOCK COMPLETION BLOCK TYPE PROGRAM ENTRY 
TD ADDRESS CODE ADDRESS NAME ADDRESS 


HHHH HHHHHH = =HHHHHH HHHHHH = HH EEEEE . HHHHHH 


0001 002438 000000 16B600 40 GDUMP 187056 
=Q01690D4 R1 =O001690F8 R2 =00169310 
=Q0000000 R4 =00000590 R5 =00000000 
=00000678 R7 =00000678 R8 =00000006 
=002FDO00 R10=00169048 R11=00009F38 
=50182F1C R13=00009F28 R14=50183280 | 
=00000001 

002518 80 CONSOLE 182EA8 
=00000000 R1 =00000000 R2 =00000000 
=Q00000000 R4 =00000000 R5 =00000000 | 
=00000000 R7 =00000000 R8 =00000000 orre 
=00000000 R10=00000000 R11=00000000 ! \ 
=00000000 R13=00000000 R14=00000000 = 

R15=00000000 


TASK BLOCK COMPLETION BLOCK PROGRAM ENTRY 
ID ADDRESS CODE ADDRESS TYPE NAME ADDRESS 
0002 002430 000000 0035B0 80 COMMAND 182A68 
=90000000 R1 =00000000 R2 =00000000 
=00000000 R4 =00000000 R5 =00000000 
=Q0000000 R7 =00000000 R8 =00000000 
=00000000 R10=00000000 R11=00000000 eo TS 
=00000000 R13=00000000 R14=00000000 , 
R15=00000000 


ae ° 
~ one 
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TLOADL Subcommand 


C 


a a faeetetceoueacncat 


Use the TLOADL subcommand to display the task load list. 


The format of the TLOADL subcommand is as follows: 


TLoad] [ taskid ALL ] 


Where: 


taskid 
identifies the task you want information about. The format is nnnn. 


ALL 
requests information for all tasks. ALL ts the default. 


Usage Notes: None. 
Responses: 


Displays for each program loaded by this task: 


e The address of the control block that contains information as to where the 
program is loaded 


e The associated program name 


e The number of times it has been loaded, but not deleted. 


Error Messages: 


CSIITLO31S Insufficient free storage is available 

CSIITL504I Page 'nnnnnnnn' not found in dump 

CSIIAL505I TASKID 'xxxxxxxx! invalid 

CSIITL535I TASKID table PRT is zero. Can't find task load list 


CSIITL5371 Task block PRT is zero. Can't find task load list 
CSIITL538I Task block list PRT is zero 


Sample Output: 


The following is an example of the output of the TLOADL subcommand. 


TASK-ID TASK-BLOCK LOAD-BLOCK PROGRAM-NAME LOAD-COUNT 


HHHH HHHHHH HHHHHH EEEEEEEE HHHH 
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TSAB Subcommand | a 
Use the TSAB subcommand to display the subpool map and chain header of a task. "a | 


The format of the GREGS subcommand 1s as follows: 


Where: 


taskid 7 
identifies the task you want information about. The format is nnnn. 


ALL 
requests information for all tasks. ALL is the default. 


Usage Notes: None. 
Responses: 


Displays the: 
e Task block address 
¢ Task storage anchor block address 
e¢ Chain header of the subpools owned by the task 
e 256-bit map of the subpools owned by the task. we PR 


Error Messages: 


CSIITLO31S Insufficient free storage is available 

CSIITL504I Page ‘nnnnnnnn' not found in dump 

CSITAL505I TASKID 'xxxxxxxx' invalid 

CSIITA539I NUCON extension PRT is zero. Can't find task storage anchor 
CSIITA540I TASKID table PRT is zero. Can't find task storage anchor blo 
CSIITL537I Task block PRT is zero. Can't find task load list 

CSTITL5381I Task block list PRT is zero 


Sample Output: — i 


The following is an example of the output of the TSAB subcommand. The first 32 
bytes of the TSAB contain the 256 bit map of the subpools owned by the task. 


TASK-ID TASK-BLOCK TASK-STORAGE-ANCHOR-BLOCK CHAIN-HEADER 
HHHH HHHHHH HHHHHH HHHHHH 


SUBPOOL-MAP: (CONSISTING OF 64 HEX DIGITS) 
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VMLOADL Subcommand 


Use the VMLOADL subcommand to display information about all programs loaded 
in this virtual machine. 


The format of the GREGS subcommand is as follows: 


Responses: 


Displays for each module loaded in this virtual machine: 
e Address of the control block containing related information 
¢ Associated program name 
¢ Program address 
e Program size 


e Entry point address. 


For an ALIAS or IDENTIFY-specified entry point, this subcommand displays: 
e Address of the control block containing related information 
e Entry point name 
¢ Entry point address 
¢ Type of control block (ALIAS or IDENTIFY). 


Error Messages: 


CSTIVL5041 Page ‘nnnnnnnn' not found in dump 
CSTIVL533I The virtual machine load list is empty. 


Sample Output: 


The following is an example of the output of the VMLOADL subcommand. 


MAJOR-NUCCBLK MOD-NAME MOD-ENTRY-ADDR MOD-SIZE MOD-ADDR 


HHHHHH EEEEEEEE = HHHHHH HHHH HHHHHH 


MAJOR-NUCCBLK ENTRY-NAME ENTRY-ADDRESS TYPE 


HHHHHH =EEEEEEEE =©HHHHHH EEEEEEEE 
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(Summary of Changes 


Second Edition 
Note: Due to the extensive changes made to this book, vertical bars have not been 
used in the left-hand margin to denote new or changed information. 
Form of Publication: SC23-0359 
Level of Product: VM/XA System Product Release 2 


Date of Publication: November 1988 


( Changes to this publication: 
¢ Group control system (GCS) 


GCS is a new component that allows you to implement a native SNA communi- 
cation network or run RSCS Version 2. 


This manual reflects the added ability to process GCS and RCSC Version 2 load 
maps (with the MAP and ADDMAP commands) as well as the load maps cur- 
rently supported. 


J -¢ Soft abend dump enhancements 


( s VM/XA System Product Release 2 enhances existing soft abend dump support 
by: 
— Providing snapshot information about abending modules’ save areas and 
associated data areas. 


This manual documents the use of the SNAPLIST subcommand of 
DUMPSCAN which allows you to view a summary snaplist in a soft abend 
dump. 


¢ Dump viewing facility enhancements 


VM/XA System Product Release 2 enhances the dump viewing facility to allow 
you to: | 


— Format any CP control block found in a CP dump or any virtual machine 
control block found in a VM/XA SP dump. You can format all or just 
selected fields as well as specify the level of formatting detail (at the bit or 
byte level) you want to see. This manual documents the BLOCK subcom- 
mand of DUMPSCAN, which formats control blocks within the dump. 

— Select which trace table entries you wish to view in a CP, stand-alone, or 
soft abend dumps. The SELECT subcommand of DUMPSCAN documents 
the ability to select trace table entries you want to see and to reduce these 
entries. through several options. 

— Process data trace information as well as CP trace table data 

— Use the XEDIT interface to extract data from dumps for use in a REXX 
EXEC. | 

— Write your own DUMPSCAN macros using the DUMPSCAN macro sub- 
commands FINDSTRG, READSTRG, and NOTE. Those subcommands 
are documented in the DUMPSCAN subcommand section of the book. The 
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creation of macros with these macro subcommands is documented in 
Chapter 2. | i 
— Use the new SCAN subcommand of DUMPSCAN to process a PF key eY 
assignment or command string to the system product interpreter 
~— Collect GCS guest trace records in a simulated OS QSAM file. This is doc- 
umented in the TRACERED command. 
— Process dumps with any CMS file name. 
— View dump data via the XEDIT interface. 
— Use an IBM-supplied EXEC to search a dump for a hung user. This is doc- 
umented under the FINDUSER subcommand of DUMPSCAN. 


e New and changed publications 


VM/XA System Product Release 2 adds two new books to the VM/XA SP 
library and combines two existing books into one book. The two new books 
are: 


—- VM/XA System Product: Group Control System Command and Macro Refer- 


ence, SC23-0433 —_— 
—- VM/XA System Product: Group Control System Diagnosis Reference, ae, 
LY27-8060. 


The combined book is VM/XA SP Release 2 Planning and Administration. This 
book replaces the VM/XA SP Release 1 Administration (SC23-0353) and VM/XA 
SP Release 1 Planning (GC23-0378) manuals. 


¢ Programming enhancements 


VM/XA System Product Release 2 provides new and changed DIAGNOSE and 
IUCV functions. | ye eS 
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Glossary 


A 


automatic software re-IPL. The process by which 
the control program attempts to restart the system 
after abnormal termination. This process does not 
involve the hardware IPL process. See also 
virtual = real machine recovery. 


Cc 


CCS. Console communication services. 
CCW. Channel command word. 


channel command word (CCW). A doubleword 
structure that directs an I/O operation on a device 
or channel and includes pointers to any storage 
areas associated with the operation. One or more 
CCWs make up a channel program. 


CMS. Conversational monitor system. 


console communication services (CCS). A group of 
CP routines that interface with the VTAM service 


machine, providing full VM/XA™ SP console capa-_ 


bilities for SNA/CCS terminal users. 


control program (CP). The component of VM/XA 
SP that manages the resources of a single 
System/370-Extended Architecture system so that 
multiple computing systems appear to exist. Each 
virtual machine is the functional equivalent of 
either a System/370 computing system or a 

System /370-Extended Architecture computing 
system. 


conversational monitor system (CMS). The compo- 
nent of VM/XA SP that, as a virtual machine oper- 
ating system, provides interactive time-sharing. 
CMS allows users to communicate with the system 
and with each other, to create and edit files, and to 
develop and run application programs. It operates 
in either System/370 mode or 370-XA mode under 
the control of CP. 


CP. Control program. 


D 


DCSS. Discontiguous saved segment. 


directory. A CP disk file that includes an entry for 
each user in the system. The entry defines the char- 
acteristics of the user’s initial virtual machine con- 
figuration. These characteristics include the userid, 
the password, normal and maximum allowable 
virtual storage, virtual device definitions, the privi- 
lege class, the dispatching priority, logical line 
editing characters, and the account number. 


discontiguous saved segment (DCSS). A saved 
segment that occupies one or more architecturally- 
defined segments. It begins and ends on segment 
boundaries. It is accessed by its own name. Con- 
trast with member saved segment. See also saved 
segment, segment, segment space. 


dump viewing facility. A VM/XA SP component 
that allows users to display, format, and print data 
interactively from CP hard and soft abend, stand- 
alone, and virtual machine dumps, and to process 
CP trace table data stored on tape or in a system 
trace file. 


dynamic paging area. The area of real storage allo- 
cated by CP for V=V machine paging. This area 
also contains CP nonresident modules, CP control 
blocks, CP trace tables, free storage pages, and the 
alternate processor’s prefix storage areas. 


E 


Expanded Storage. Optional integrated high-speed 
storage. In VM/XA SP, Expanded Storage may be 
shared by CP and one or more virtual machines. It 
may also be dedicated to CP or to a particular 
virtual machine. 


VM/XA is a trademark of the International Business Machines Corporation. 
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full-pack minidisk. _ A virtual disk that contains all 
of the addressable cylinders of a real DASD 
volume. 


full-screen mode. In VM/XA SP, the environment 


in which an entire 3270 display screen is under the 
control of a program running in a virtual machine. 


G 
GCS. Group control system. 
group control system (GCS). The component of 


VM/XA SP that, as a virtual machine supervisor, 
executes in a group of System/370 virtual machines 


under CP control to provide an interface that helps — 


support a native Systems Network Architecture 
(SNA) network. 


guest. An operating system running in a virtual 
machine managed by the VM/XA SP control 
program. Contrast with host. 


guest real storage. The storage that appears real to 
the operating system running in a virtual machine. 
Contrast with guest virtual storage, host real 
storage, and host virtual storage. 


guest virtual storage. The storage that appears 
virtual to the operating system running in a virtual 
machine. Contrast with guest real storage, host real 
storage, and host virtual storage. 


| 


host. The VM/XA SP control program in its 
capacity as manager of a virtual machine in which 
another operating system is running. Contrast with 
guest. 


host real storage. The storage that appears real to 
the control program. If VM/XA SP is running 
native, this is real storage; if VM/XA SP is running 


in a virtual machine, this 1s virtual storage. Con- 
trast with guest real storage, guest virtual storage, 
and host virtual storage. | 


host virtual storage. The storage that appears 
virtual to the control program. Contrast with guest 
real storage, guest virtual storage, and host real 
storage. 


image library. A set of modules, contained in a 
system data file, that define the spacing, characters, 
and copy modification data that a 3800 printer uses 
to print a spool file or that define the spacing and 
character set that an impact printer uses to print a 
spool file. See also system data file. 


inter-user communication vehicle (IUCV). A gener- 
alized CP interface that facilitates the transfer of 
data among virtual machines. 


IUCV. Inter-user communication vehicle. 


member saved segment. A saved segment that 
begins and ends on a page boundary. It belongs to 
up to 64 segment spaces and is accessed either by 
the segment space name or by its own name. Con- 
trast with discontiguous saved segment. See also 
saved segment, segment, segment space. 


message repository file. A type of system data file 
that contains a set of VM/XA SP messages trans- 
lated into a national language. 


missing interrupt handler. A CP function for 
detecting and dealing with real I/O operations that 
do not complete within a specified time. 


multiple preferred guests. A VM/XA SP facility 
that supports up to six preferred virtual machines 
when the Processor Resource/Systems Manager™ 
(PR/SM™) feature is installed in the real machine. 
See also preferred virtual machine. 


Processor Resource/Systems Manager and PR/SM are trademarks of the International Business Machines Cor- 


poration. 
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N 


named saved system (NSS). A copy of an operating 
system that a user has named and retained in a 
system data file. The user can load the operating 
system by its name, which is more efficient than 
loading it by device number. See also discontiguous 
saved segment, member saved segment, saved 
segment, segment space, system data file. 


NSS. Named saved system. 


p 


pageable virtual machine. Synonymous with 
virtual = virtual machine. 


preferred virtual machine. A virtual machine that 
runs in the V=R area. CP gives this virtual 
machine preferred treatment in the areas of per- 
formance, processor assignment, and I/O interrupt 
handling. See also multiple preferred guests, 
virtual = fixed machine, virtual=real area, 

virtual = real machine. 


Processor Resource/Systems Manager (PR/SM). A 
separately orderable feature available with 3090E 
processors that provides for logical partitioning of 
the real machine and support of multiple preferred 
guests. See also multiple preferred guests. 


PR/SM. Processor Resource/Systems Manager. 


R 


real system operator. Any user who loads and runs 
VM/XA SP in the real machine. Contrast with 
virtual machine operator. 


S 


saved segment. One or more pages of storage that 
have been named and retained in a system data file. 
See also discontiguous saved segment, member 
saved segment, segment, segment space, system data 
file. 


segment. In System/370 architecture, 64 kilobytes 
of storage. In 370-XA architecture, | megabyte of 
storage. See also saved segment. 


segment space. A saved segment composed of up 
to 64 member saved segments accessed by a single 


name. A segment space occupies one or more 
architecturally-defined segments; it begins and ends 
on segment boundaries. A user with access to a 
segment space has access to all of 1ts members. See 
also discontiguous saved segment, member saved 
segment, saved segment, segment. 


service virtual machine. A virtual machine that pro- 
vides system services. These services include 
accounting, error recording, monitoring, and those 
provided by supported licensed programs. 


SMSG function. A CP function that allows a 
virtual machine to send a special message to 
another virtual machine programmed to accept and 
process the message. See also special message. 


SNA. Systems Network Architecture. 


SNA/CCS terminal. Any terminal accessing 
VM/XA SP that is managed by a VTAM service 
machine. 


special message. A data transmission, made up of 
instructions or commands, sent from one virtual 
machine to another via the SMSG function. A 
special message 1s processed by the receiving virtual 
machine and does not appear on the receiver’s 
console. See also SMSG function. 


spool file. A collection of data along with CCWs 
for processing on a unit record device. Contrast 
with system data file. 


SVC 76. In VM/XA SP, a supervisor call instruc- 
tion that records the error incidents encountered by 
certain operating systems running in virtual 
machines. When a virtual machine operating 
system issues an SVC 76, VM/XA SP translates the 
virtual storage and I/O device addresses to real 
addresses, records the information on the VM/XA 
SP error recording virtual machine, and returns 
control to the issuing virtual machine. This inter- 
face bypasses the virtual machine’s own error 
recording routine, and avoids duplicate error 
recording. 


System/370 mode. A virtual machine operating 
mode in which System/370 functions are simulated. 
Contrast with 370-XA mode. 


system data file. A collection of data associated 
with a particular function. Types of system data 
files include saved segments, NSSs, UCR files, 
image libraries, message repository files, and system 
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trace files. Because a system data file contains no 
CCWs, it cannot be processed on a unit record 
device. Contrast with spool file. 


system hold status. A spool file status that prevents 
a file from being printed, punched, or read until the 
real system operator releases it. Contrast with user 
hold status. 


system trace file. A type of system data file that 
contains CP or virtual machine trace data. 


Systems Network Architecture (SNA). The 
description of the logical structure, formats, proto- 
cols, and operational sequences for transmitting 
information units through, and controlling the con- 
figuration and operation of, networks. 


U 


UCR file. User class restructure file. 
unit record device. A reader, a printer, or a punch. 


user class restructure file (UCR file). A type of 
system data file that contains information used to 
override the IBM-defined privilege class structure of 
CP commands, DIAGNOSE instruction codes, and 
certain CP system functions. 


user directory. See directory. 


user hold status. A spool file status that prevents a 
file from being printed, punched, or read until the 
file owner releases it. Contrast with system hold 
Status. 


V 


Vector Facility (VF). A hardware feature that pro- 
vides synchronous instruction processing for high- 
speed manipulation of fixed-point and 
floating-point data. 


VF. Vector Facility. 
V=F machine. Virtual = fixed machine. 
virtual = fixed machine (V=F machine). A pre- 


ferred virtual machine with a fixed, contiguous area 
of host real storage that does not start at page 0. 


CP provides performance enhancements for this — 
virtual machine. See also multiple preferred guests, 
preferred virtual machine, virtual =real area, 
virtual = real machine, virtual = virtual machine. 


virtual machine. In VM/XA SP, a functional equiv- 
alent of either a System/370 computing system or a 
System/370-Extended Architecture computing 
system. Each virtual machine is controlled by an 
operating system. VM/XA SP controls the concur- 
rent execution of multiple virtual machines on an 
actual System/370-Extended Architecture system. 


Virtual Machine/Extended Architecture™ System 
Product (VM/XA SP). An operating system that 
allows multiple IBM System/370 and 370-XA oper- 
ating systems to run simultaneously on a single 
370-XA processor. The multiple systems may be 
used for production, testing, developing application 
programs, maintenance, and migration. VM/XA 


_ SP also provides a high-capacity interactive envi- 


ronment. There are four components: the control 
program (CP), the conversational monitor system 
(CMS), the dump viewing facility, and the group 
control system (GCS). 


virtual machine operator. Any user who loads and 
runs an operating system in a virtual machine. 
Contrast with real system operator. 


virtual = real area (V=R area). A fixed, contiguous 
section of real storage, starting at page 0, in which 
preferred virtual machines execute. CP does not 
page this storage. See also preferred virtual 
machine, virtual = fixed machine, virtual = real 
machine. 


virtual = real machine (V=R machine). A preferred 
virtual machine with a fixed, contiguous area of 
host real storage that starts at page 0. CP provides 
performance enhancements and an automatic 
recovery facility for this virtual machine. See also 
multiple preferred guests, preferred virtual machine, 
virtual = real area, virtual =real machine recovery, 
virtual = virtual machine. 


- virtual = real machine recovery (V = R machine 


recovery). A CP function that allows the V=R 
machine to resume operation after most CP 
abnormal terminations. When possible, the facility 
reestablishes the V=R machine environment, 


Virtual Machine/Extended Architecture is a trademark of the International Business Machines Corporation. 
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allowing the operating system running in that 
virtual machine to perform its own recovery proc- 
esses. See also automatic software re-IPL. 


virtual = virtual machine (V=V machine). A virtual 
machine that runs in the dynamic paging area. CP 
pages this virtual machine’s guest real storage in 
and out of host real storage. See also dynamic 
paging area, virtual = fixed machine, virtual = real 
machine. 


virtual supervisor state. A condition, controlled by 
a virtual machine’s current PSW, during which the 
control program allows the virtual machine to issue 
input/output and other privileged instructions. 
When these instructions are not emulated, the 
control program intercepts these instructions and 
simulates their functions for the virtual machine. 


virtual wait time. The period during which the 
control program suspends the processing of a 
program while a required resource is unavailable. 


VM/XA SP. Virtual Machine/Extended Architec- 
ture System Product. 


VTAM service machine. A collection of networking 
programs running in a virtual machine that, 


together with the CP console communication ser- 
vices (CCS) routines, provide full VM/XA SP 
console capabilities for SNA/CCS terminal users. 
A VTAM service machine contains either (1) 
VM/VTAM with VSCS running as an application 
under control of GCS, or (2) VM/VCNA running 
as a VTAM application under control of the VSE 
or VS1 operating system. 


V=R area. Virtual=real area. 
V=R machine. Virtual =real machine. 


V=R machine recovery. Virtual=real machine 
recovery. 


V=V machine. Virtual =virtual machine. 


Numerics 

370 mode. Synonym for System/370 mode. 
370-XA mode. A virtual machine operating mode 
in which System/370-Extended Architecture func- 


tions are simulated. Contrast with System/370 
mode. 
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Bibliography 


This bibliography gives the names and order numbers of microfiche and publications 
about VM/XA System 


VM/XA System Product Microfiche 


You can order microfiche listings that contain code. The order numbers for the 


microfiche are: 


Order No. 
LYC7-0330 
LYC7-0331 
de LYC7-0332 
( LYC7-0334 


Description | 

VM/XA System Product: CP listings 

VM/XA System Product: CMS listings | 

VM/XA System Product: GCS listings | 

VM/XA System Product: dump viewing facility listings. 


VM/XA System Product Publications 


The publications are shown in Figure 91 on page 268. You can order any of them 
by their individual order numbers or you can order most of them as a group by 
using a single order number, SBOF-0260. SBOF-0260 provides: 


eo e All unlicensed publications (order numbers that do not begin with LY) 
( d e Enough three-ring binders to hold the publications 
¢ Spine and cover inserts for the binders. 
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Quick Reference 
$X23-0391 


Figure 91 (Part 1 of 2). VM/XA System Product Publications 
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System Product 
Editor 
User’s Guide 
$C23-0373 
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Specifications 
GC23-0366 


System Produc 


Features 
Summary 
LY27-8058 


System Product 


CMS 
User’s Guide 
$C23-0356 


System Product 


System Product 
Editor 
Command and 


Macro Reference 
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